paweld/lazarus
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/lazarus/lazarus.git synced 2025-04-09 01:28:19 +02:00
Code Issues Packages Projects Releases Wiki Activity

Revert "Docs: LCL/lresources. Adds deprecation notices in TUTF8Parser topics for changes in 5b65498e."

Browse Source 
This reverts commit e01852c60035fe0d57cfddd2adc48c2750c074a2.
This commit is contained in:
dsiders 2023-11-18 21:26:01 +00:00
parent 92a606dd94
commit 9b65222e3f
1 changed files with 156 additions and 154 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

310
docs/xml/lcl/lresources.xml
View File

@ -53,7 +53,7 @@ Author: Mattias Gaertner
</p>
</descr>
<!-- unresolved type references -->
<!-- unresolved type reference Visibility: default -->
<element name="Windows"/>
<element name="Classes"/>
<element name="SysUtils"/>
@ -1750,10 +1750,9 @@ pointer to the item data.
<seealso/>
</element>
<!-- Deprecated in 5b65498e. -->
<element name="TUTF8Parser">
<short>
Deprecated. Parser for UTF-8-encoded identifiers, string, and number literals.
Parser for UTF-8-encoded identifiers, string, and number literals.
</short>
<descr>
<p>
@ -1787,34 +1786,71 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<!-- private -->
<element name="TUTF8Parser.fStream"/>
<element name="TUTF8Parser.fBuf"/>
<element name="TUTF8Parser.fBufLen"/>
<element name="TUTF8Parser.fPos"/>
<element name="TUTF8Parser.fLineStart"/>
<element name="TUTF8Parser.fFloatType"/>
<element name="TUTF8Parser.fSourceLine"/>
<element name="TUTF8Parser.fToken"/>
<element name="TUTF8Parser.fEofReached"/>
<element name="TUTF8Parser.fLastTokenStr"/>
<element name="TUTF8Parser.GetTokenName">
<short>
Deprecated. The name of a token, maybe the Token character itself.
</short>
<element name="TUTF8Parser.fStream">
<short>The input stream.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.GetTokenName.Result"/>
<element name="TUTF8Parser.GetTokenName.aTok"/>
<element name="TUTF8Parser.fBuf">
<short>The allocated buffer.</short>
<descr/>
<seealso/>
</element>
<element name="TUTF8Parser.fBufLen">
<short>Number of valid chars (bytes) in the buffer.</short>
<descr/>
<seealso/>
</element>
<element name="TUTF8Parser.fPos">
<short>Current position (index) in the buffer.</short>
<descr/>
<seealso/>
</element>
<element name="TUTF8Parser.fLineStart">
<short>Buffer-relative begin of the current line.
</short>
<descr>column = fPos - fLineStart + 1
</descr>
<seealso/>
</element>
<element link="#lcl.lresources.TUTF8Parser.FloatType" name="TUTF8Parser.fFloatType"/>
<element link="#lcl.lresources.TUTF8Parser.SourceLine" name="TUTF8Parser.fSourceLine"/>
<element link="#lcl.lresources.TUTF8Parser.Token" name="TUTF8Parser.fToken"/>
<element name="TUTF8Parser.fEofReached">
<short>True when reached the end of the input stream.</short>
<descr/>
<seealso/>
</element>
<element name="TUTF8Parser.fLastTokenStr">
<short>Holds the last parsed token text.</short>
<descr/>
<seealso/>
</element>
<element name="TUTF8Parser.GetTokenName">
<short>The name of a token, maybe the Token character itself.</short>
<descr/>
<seealso/>
</element>
<element name="TUTF8Parser.GetTokenName.Result">
<short/>
</element>
<element name="TUTF8Parser.GetTokenName.aTok">
<short/>
</element>
<element name="TUTF8Parser.LoadBuffer">
<short>
Deprecated. Fills the buffer from the input stream.
</short>
<short>Fills the buffer from the input stream.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -1823,9 +1859,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.CheckLoadBuffer">
<short>
Deprecated. Skips to the next non-null character.
</short>
<short>Skips to the next non-null character.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -1834,9 +1868,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.ProcessChar">
<short>
Deprecated. Add the current character to the token string.
</short>
<short>Add the current character to the token string.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -1845,89 +1877,89 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.IsNumber">
<short>
Deprecated. True when the current character is a digit.
</short>
<short>True when the current character is a digit.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.IsNumber.Result"/>
<element name="TUTF8Parser.IsNumber.Result">
<short/>
</element>
<element name="TUTF8Parser.IsHexNum">
<short>
Deprecated. True when the current character is a hex digit.
</short>
<short>True when the current character is a hex digit.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.IsHexNum.Result"/>
<element name="TUTF8Parser.IsHexNum.Result">
<short/>
</element>
<element name="TUTF8Parser.IsAlpha">
<short>
Deprecated. True when the current character is an ASCII character (or
underscore).
True when the current character is an ASCII character (or underscore).
</short>
<descr>
Should mean: all allowed characters in an identifier.
[To be updated for Unicode identifiers].
<descr>Should mean: all allowed characters in an identifier.
[To be updated for Unicode identifiers]
</descr>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.IsAlpha.Result"/>
<element name="TUTF8Parser.IsAlpha.Result">
<short/>
</element>
<element name="TUTF8Parser.IsAlphaNum">
<short>
Deprecated. True when the current character is a digit or IsAlpha.
</short>
<short>True when the current character is a digit or IsAlpha.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.IsAlphaNum.Result"/>
<element name="TUTF8Parser.IsAlphaNum.Result">
<short/>
</element>
<element name="TUTF8Parser.GetHexValue">
<short>
Deprecated. Returns the value of a hex digit.
</short>
<short>Returns the value of a hex digit.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.GetHexValue.Result"/>
<element name="TUTF8Parser.GetHexValue.c"/>
<element name="TUTF8Parser.GetHexValue.Result">
<short/>
</element>
<element name="TUTF8Parser.GetHexValue.c">
<short/>
</element>
<element name="TUTF8Parser.GetAlphaNum">
<short>
Deprecated. Parses and returns an identifier.
</short>
<short>Parses and returns an identifier.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<errors>
EParserError when the current character is not valid for an identifier.
</errors>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.GetAlphaNum.Result"/>
<element name="TUTF8Parser.GetAlphaNum.Result">
<short/>
</element>
<element name="TUTF8Parser.HandleNewLine">
<short>
Deprecated. Skip CR/LF, adjust SourceLine.
</short>
<short>Skip CR/LF, adjust SourceLine.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -1936,9 +1968,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.SkipSpaces">
<short>
Deprecated. Skip space and tab chars.
</short>
<short>Skip space and tab chars.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -1947,9 +1977,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.SkipWhitespace">
<short>
Deprecated. Skip all whitespace characters.
</short>
<short>Skip all whitespace characters.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -1958,9 +1986,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.HandleEof">
<short>
Deprecated. Marks end of input reached (fEofReached).
</short>
<short>Marks end of input reached (fEofReached).</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -1969,9 +1995,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.HandleAlphaNum">
<short>
Deprecated. Parse an identifier.
</short>
<short>Parse an identifier.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -1980,10 +2004,8 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.HandleNumber">
<short>
Deprecated. Parse a number, recognizing trailing floating point format
specifiers.
</short>
<short>Parse a number,
recognizing trailing floating point format specifiers.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -2007,22 +2029,24 @@ EParserError when no valid hex digit was found.
<element name="TUTF8Parser.HandleQuotedString">
<short>
Deprecated. Parse an quoted string, excluding the leading and trailing quotes.
Parse an quoted string, excluding the leading and trailing quotes.
</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<errors>
EParserError on an unterminated string literal.
</errors>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.HandleQuotedString.Result"/>
<element name="TUTF8Parser.HandleQuotedString.Result">
<short/>
</element>
<element name="TUTF8Parser.HandleDecimalString">
<short>
Deprecated. Parse an decimal Unicode codepoint, return it as an UTF-8 string.
Parse an decimal Unicode codepoint, return it as an UTF-8 string.
</short>
<descr/>
<version>
@ -2036,9 +2060,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.HandleString">
<short>
Deprecated. Parses a string literal.
</short>
<short>Parses a string literal.</short>
<descr>
<p>
The string can consist of quoted strings and Unicode codepoints.
@ -2058,8 +2080,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.HandleMinus">
<short>
Deprecated. Tries to parse a negative number, or a single '-' character.
<short>Tries to parse a negative number, or a single '-' character.
</short>
<descr/>
<version>
@ -2082,9 +2103,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
<!-- public -->
<element name="TUTF8Parser.Create">
<short>
Deprecated. Constructor for the class instance.
</short>
<short>Constructor for the class instance.</short>
<descr>
<p>
<var>Create</var> is the constructor for the class instance.
@ -2108,9 +2127,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.Destroy">
<short>
Deprecated. Destructor for the class instance.
</short>
<short>Destructor for the class instance.</short>
<descr>
<p>
<var>Destroy</var> is the overridden destructor for the class instance. It
@ -2126,16 +2143,10 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.CheckToken">
<short>
Deprecated. Asserts that Token is of the expected type.
</short>
<short>Asserts that Token is of the expected type.</short>
<descr/>
<version>
Deprecated in LCL version 4.0. Use Classes.TParser instead.
</version>
<seealso/>
<errors>
EParserError when Token doesn't match the expected type.
<errors>EParserError when Token doesn't match the expected type.
</errors>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -2146,16 +2157,11 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.CheckTokenSymbol">
<short>
Deprecated. Asserts that the given name was parsed (case insensitive).
<short>Asserts that the given name was parsed (case insensitive).
</short>
<descr/>
<version>
Deprecated in LCL version 4.0. Use Classes.TParser instead.
</version>
<seealso/>
<errors>
EParserError when Token doesn't match the expected type or name.
<errors>EParserError when Token doesn't match the expected type or name.
</errors>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -2166,8 +2172,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.Error">
<short>
Deprecated. Raises an EParserError with the given message.
<short>Raises an EParserError with the given message.
</short>
<descr/>
<version>
@ -2180,8 +2185,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.ErrorFmt">
<short>
Deprecated. Raises an EParserError with the formatted message.
<short>Raises an EParserError with the formatted message.
</short>
<descr/>
<version>
@ -2197,9 +2201,8 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.ErrorStr">
<short>
Deprecated. Raises an EParserError with the given message, adding source
position information.
<short>Raises an EParserError with the given message, adding source position
information.
</short>
<descr/>
<version>
@ -2207,11 +2210,12 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.ErrorStr.Message"/>
<element name="TUTF8Parser.ErrorStr.Message">
<short/>
</element>
<element name="TUTF8Parser.HexToBinary">
<short>
Deprecated. Writes an hex value into the output stream.
<short>Writes an hex value into the output stream.
</short>
<descr>
<p>
@ -2248,21 +2252,20 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.SourcePos">
<short>
Deprecated. Returns the current position in the input stream.
</short>
<short>Returns the current position in the input stream.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.SourcePos.Result"/>
<element name="TUTF8Parser.SourcePos.Result">
<short/>
</element>
<element name="TUTF8Parser.TokenComponentIdent">
<short>
Deprecated. Parses an (possibly) qualified identifier, after a symbol has been
parsed.
Parses an (possibly) qualified identifier, after a symbol has been parsed.
</short>
<descr/>
<errors>
@ -2273,12 +2276,12 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.TokenComponentIdent.Result"/>
<element name="TUTF8Parser.TokenComponentIdent.Result">
<short/>
</element>
<element name="TUTF8Parser.TokenFloat">
<short>
Deprecated. Returns the binary value of a floating point number.
</short>
<short>Returns the binary value of a floating point number.</short>
<descr/>
<errors>
EParserError on an invalid number.
@ -2288,23 +2291,24 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.TokenFloat.Result"/>
<element name="TUTF8Parser.TokenFloat.Result">
<short/>
</element>
<element name="TUTF8Parser.TokenInt">
<short>
Deprecated. Returns the binary value of an integral number.
</short>
<short>Returns the binary value of an integral number.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.TokenInt.Result"/>
<element name="TUTF8Parser.TokenInt.Result">
<short/>
</element>
<element name="TUTF8Parser.TokenString">
<short>
Deprecated. Returns the last parsed token as an string.
<short>Returns the last parsed token as an string.
</short>
<descr/>
<version>
@ -2312,11 +2316,12 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.TokenString.Result"/>
<element name="TUTF8Parser.TokenString.Result">
<short/>
</element>
<element name="TUTF8Parser.TokenSymbolIs">
<short>
Deprecated. Compares the parsed symbol with the given string (case-insensitive).
<short>Compares the parsed symbol with the given string (case-insensitive).
</short>
<descr/>
<version>
@ -2327,11 +2332,13 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
<element name="TUTF8Parser.TokenSymbolIs.Result">
<short>True when a matching symbol has been parsed.</short>
</element>
<element name="TUTF8Parser.TokenSymbolIs.S"/>
<element name="TUTF8Parser.TokenSymbolIs.S">
<short/>
</element>
<element name="TUTF8Parser.FloatType">
<short>
Deprecated. The type of the parsed floating point number. (number, date...).
The type of the parsed floating point number. (number, date...).
</short>
<descr/>
<version>
@ -2341,8 +2348,7 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.SourceLine">
<short>
Deprecated. The current line number in the input stream.
<short>The current line number in the input stream.
</short>
<descr/>
<version>
@ -2352,21 +2358,17 @@ Deprecated in LCL version 3.0. Use Classes.TParser instead.
</element>
<element name="TUTF8Parser.SourceColumn">
<short>
Deprecated. The current column number in the source line.
<short>The current column number in the source line.
</short>
<descr/>
<version>
Deprecated in LCL version 4.0. Use Classes.TParser instead.
</version>
<seealso/>
</element>
<element name="TUTF8Parser.SourceColumn.Result"/>
<element name="TUTF8Parser.SourceColumn.Result">
<short/>
</element>
<element name="TUTF8Parser.Token">
<short>
Deprecated. The last parsed token type.
</short>
<short>The last parsed token type.</short>
<descr/>
<version>
Deprecated in LCL version 3.0. Use Classes.TParser instead.
@ -2380,7 +2382,7 @@ A queue to stream components, used for multi-threading or network.
</short>
<descr>
<p>
ConvertComponentAsString converts a component to binary format with leading
ConvertComponentAsString converts a component to binary format with a leading
size information (using WriteLRSInt64MB).
</p>
<p>