This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH v3][BZ #17787] Fix exponents in manual.
- From: "Carlos O'Donell" <carlos at redhat dot com>
- To: OndÅej BÃlka <neleai at seznam dot cz>
- Cc: Joseph Myers <joseph at codesourcery dot com>, Andreas Schwab <schwab at linux-m68k dot org>, libc-alpha at sourceware dot org
- Date: Thu, 18 Jun 2015 11:26:06 -0400
- Subject: Re: [PATCH v3][BZ #17787] Fix exponents in manual.
- Authentication-results: sourceware.org; auth=none
- References: <20150105121124 dot GA20619 at domone> <871tn9joub dot fsf at igel dot home> <20150106115720 dot GA19882 at domone> <20150616175738 dot GD9387 at domone> <alpine dot DEB dot 2 dot 10 dot 1506162002000 dot 31875 at digraph dot polyomino dot org dot uk> <55808614 dot 3060409 at redhat dot com> <20150618142917 dot GA16523 at domone>
On 06/18/2015 10:29 AM, OndÅej BÃlka wrote:
> On Tue, Jun 16, 2015 at 04:24:52PM -0400, Carlos O'Donell wrote:
>> On 06/16/2015 04:07 PM, Joseph Myers wrote:
>>> On Tue, 16 Jun 2015, OndÅej BÃlka wrote:
>>>
>>>> Ping, if you have better idea I would like it.
>>>
>>> I've looked back at the previous discussion. It seems clear enough that:
>>>
>>> * It's a bad idea to duplicate parts of sentences that don't need
>>> duplicating. Conditionals in the main manual should be around lines with
>>> nothing more than the single word using @math.
>>
>> It's bad, but it's not terrible. I would rather see the manual get updated
>> than nit pick over the exact ways that this can get fixed.
>>
>>> * It should be possible to use a Texinfo macro for this and so avoid any
>>> conditionals at all in the main manual. Something like (untested)
>>>
>>> @iftex
>>> @macro twoexp{exp}
>>> 2^{\exp\}
>>> @end macro
>>> @end iftex
>>> @ifnottex
>>> @macro twoexp{exp}
>>> 2^{exp}
>>> @end macro
>>> @end itnottex
>>>
>>> (and then use @twoexp{63} etc.).
>>
>> That's a good suggestion.
>>
>> Cheers,
>> Carlos.
>
> Thanks that works after fixing two typos. Here I use twoexp.
>
> * manual/filesys.texi: Fix exponents.
> * manual/llio.texi: Likewise.
> * manual/stdio.texi: Likewise.
Looks good to me.
Cheers,
Carlos.