mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
79d1a3cc7e
`FILE_PATTERNS` is a space-separated list, in contrary to what is suggested by its documentation. The pattern `*.h, *.c` does not match header files but files with `.h,` extension only. Rewriting the current comma-separated pattern makes Doxygen actually process header files. However, it also reveals several hitherto hidden issues (mostly missing documentation) in the code. This patch fixes some of these documentation problems (and lists the files with outstanding issues in a 'backlog'). JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
121 lines
3.8 KiB
C
121 lines
3.8 KiB
C
/* Copyright JS Foundation and other contributors, http://js.foundation
|
||
*
|
||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
* you may not use this file except in compliance with the License.
|
||
* You may obtain a copy of the License at
|
||
*
|
||
* http://www.apache.org/licenses/LICENSE-2.0
|
||
*
|
||
* Unless required by applicable law or agreed to in writing, software
|
||
* distributed under the License is distributed on an "AS IS" BASIS
|
||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
* See the License for the specific language governing permissions and
|
||
* limitations under the License.
|
||
*/
|
||
|
||
#ifndef JS_PARSER_LIMITS_H
|
||
#define JS_PARSER_LIMITS_H
|
||
|
||
/** \addtogroup parser Parser
|
||
* @{
|
||
*
|
||
* \addtogroup jsparser JavaScript
|
||
* @{
|
||
*
|
||
* \addtogroup jsparser_internals Internals
|
||
* @{
|
||
*/
|
||
|
||
/**
|
||
* Maximum identifier length accepted by the parser.
|
||
* Limit: LEXER_MAX_STRING_LENGTH.
|
||
*/
|
||
#ifndef PARSER_MAXIMUM_IDENT_LENGTH
|
||
#define PARSER_MAXIMUM_IDENT_LENGTH 255
|
||
#endif /* !PARSER_MAXIMUM_IDENT_LENGTH */
|
||
|
||
/**
|
||
* Maximum string limit.
|
||
* Limit: 2147483647 / 65535.
|
||
*/
|
||
#ifdef JERRY_CPOINTER_32_BIT
|
||
#define PARSER_MAXIMUM_STRING_LIMIT 2147483647
|
||
#else /* !JERRY_CPOINTER_32_BIT */
|
||
#define PARSER_MAXIMUM_STRING_LIMIT 65535
|
||
#endif /* JERRY_CPOINTER_32_BIT */
|
||
|
||
/**
|
||
* Maximum string length.
|
||
* Limit: PARSER_MAXIMUM_STRING_LIMIT.
|
||
*/
|
||
#ifndef PARSER_MAXIMUM_STRING_LENGTH
|
||
#define PARSER_MAXIMUM_STRING_LENGTH PARSER_MAXIMUM_STRING_LIMIT
|
||
#endif /* !PARSER_MAXIMUM_STRING_LENGTH */
|
||
|
||
/**
|
||
* Maximum number of literals.
|
||
* Limit: 32767. Recommended: 510, 32767
|
||
*/
|
||
#ifndef PARSER_MAXIMUM_NUMBER_OF_LITERALS
|
||
#define PARSER_MAXIMUM_NUMBER_OF_LITERALS 32767
|
||
#endif /* !PARSER_MAXIMUM_NUMBER_OF_LITERALS */
|
||
|
||
/**
|
||
* Maximum number of registers.
|
||
* Limit: PARSER_MAXIMUM_NUMBER_OF_LITERALS
|
||
*/
|
||
#ifndef PARSER_MAXIMUM_NUMBER_OF_REGISTERS
|
||
#define PARSER_MAXIMUM_NUMBER_OF_REGISTERS 256
|
||
#endif /* !PARSER_MAXIMUM_NUMBER_OF_REGISTERS */
|
||
|
||
/**
|
||
* Maximum code size.
|
||
* Limit: 16777215. Recommended: 65535, 16777215.
|
||
*/
|
||
#ifndef PARSER_MAXIMUM_CODE_SIZE
|
||
#define PARSER_MAXIMUM_CODE_SIZE (65535 << (JMEM_ALIGNMENT_LOG))
|
||
#endif /* !PARSER_MAXIMUM_CODE_SIZE */
|
||
|
||
/**
|
||
* Maximum number of values pushed onto the stack by a function.
|
||
* Limit: 65500. Recommended: 1024.
|
||
*/
|
||
#ifndef PARSER_MAXIMUM_STACK_LIMIT
|
||
#define PARSER_MAXIMUM_STACK_LIMIT 1024
|
||
|
||
#endif /* !PARSER_MAXIMUM_STACK_LIMIT */
|
||
|
||
/* Checks. */
|
||
|
||
#if (PARSER_MAXIMUM_STRING_LENGTH < 1) || (PARSER_MAXIMUM_STRING_LENGTH > PARSER_MAXIMUM_STRING_LIMIT)
|
||
#error "Maximum string length is not within range."
|
||
#endif /* (PARSER_MAXIMUM_STRING_LENGTH < 1) || (PARSER_MAXIMUM_STRING_LENGTH > PARSER_MAXIMUM_STRING_LIMIT) */
|
||
|
||
#if (PARSER_MAXIMUM_IDENT_LENGTH < 1) || (PARSER_MAXIMUM_IDENT_LENGTH > PARSER_MAXIMUM_STRING_LENGTH)
|
||
#error "Maximum identifier length is not within range."
|
||
#endif /* (PARSER_MAXIMUM_IDENT_LENGTH < 1) || (PARSER_MAXIMUM_IDENT_LENGTH > PARSER_MAXIMUM_STRING_LENGTH) */
|
||
|
||
#if (PARSER_MAXIMUM_NUMBER_OF_LITERALS < 1) || (PARSER_MAXIMUM_NUMBER_OF_LITERALS > 32767)
|
||
#error "Maximum number of literals is not within range."
|
||
#endif /* (PARSER_MAXIMUM_NUMBER_OF_LITERALS < 1) || (PARSER_MAXIMUM_NUMBER_OF_LITERALS > 32767) */
|
||
|
||
#if (PARSER_MAXIMUM_NUMBER_OF_REGISTERS > PARSER_MAXIMUM_NUMBER_OF_LITERALS)
|
||
#error "Maximum number of registers is not within range."
|
||
#endif /* (PARSER_MAXIMUM_NUMBER_OF_REGISTERS > PARSER_MAXIMUM_NUMBER_OF_LITERALS) */
|
||
|
||
#if (PARSER_MAXIMUM_CODE_SIZE < 4096) || (PARSER_MAXIMUM_CODE_SIZE > 16777215)
|
||
#error "Maximum code size is not within range."
|
||
#endif /* (PARSER_MAXIMUM_CODE_SIZE < 4096) || (PARSER_MAXIMUM_CODE_SIZE > 16777215) */
|
||
|
||
#if (PARSER_MAXIMUM_STACK_LIMIT < 16) || (PARSER_MAXIMUM_STACK_LIMIT > 65500)
|
||
#error "Maximum function stack usage is not within range."
|
||
#endif /* (PARSER_MAXIMUM_STACK_LIMIT < 16) || (PARSER_MAXIMUM_STACK_LIMIT > 65500) */
|
||
|
||
/**
|
||
* @}
|
||
* @}
|
||
* @}
|
||
*/
|
||
|
||
#endif /* !JS_PARSER_LIMITS_H */
|