[PATCH v2 4/7] ld.texi: Add ASCII to info file

[Ulf Samuelsson]

Den 2024-07-08 kl. 08:23, skrev Jan Beulich:
> On 05.07.2024 18:22, binutils@emagii.com wrote:
>> --- a/ld/ld.texi
>> +++ b/ld/ld.texi
>> @@ -5643,6 +5643,7 @@ C identifiers because they contain a @samp{.} character.
>>   @cindex section data
>>   @cindex output section data
>>   @kindex ASCIZ ``@var{string}''
>> +@kindex ASCII (@var{expression}) ``@var{string}''
> I couldn't really spot anywhere you would say what has changed from the
> earlier version, so I'm unsure: Are, as per above, parentheses still
> required here, or ...
>
>> @@ -5691,6 +5692,28 @@ For example, this string of 16 characters will create a 17 byte area
>>     ASCIZ "This is 16 bytes"
>>   @end smallexample
>>   
>> +You can include a fixed size string in an output section by using
>> +@code{ASCII}.  The keyword is followed by a size and a string
>> +separated by a comma.  The string is stored at the current
>> +value of the location counter. If the string is shorted than the allocated
>> +size, NUL character are added at the end to fill up to the specified size.
>> +Note the fill value is ignored for this padding.
>> +If the string includes spaces it must be enclosed in double
>> +quotes.  The string may contain '\n', '\r', '\t' and octal numbers.
>> +Hex numbers are not supported.
>> +
>> +If the string is too long, a warning is issued and the string is
>> +truncated.  The string will still be zero-terminated in this case.
>> +
>> +If the expression evaluates to zero then the directive will be treated
>> +as if it were @code{ASCIZ} instead.
>> +
>> +Example: This is string of 16 characters and will create a 16 byte
>> +area, not zero-terminated.
>> +@smallexample
>> +  ASCII 16, "This is 16 bytes"
>> +@end smallexample
> ... are they not anymore, as per this and the cover letter?
>
> Jan

I changed it from

ASCII '(' <size> ')' <string>

to

ASCII <size> ',' <string>


-- 
Best Regards
Ulf Samuelsson