bug-gnulib
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH 1/4] ptsname_r: new module


From: Bruno Haible
Subject: Re: [PATCH 1/4] ptsname_r: new module
Date: Wed, 9 Nov 2011 00:03:53 +0100
User-agent: KMail/1.13.6 (Linux/2.6.37.6-0.5-desktop; KDE/4.6.0; x86_64; ; )

Hi Karl, all,

>     > +MacOS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX
> 
>     Could you please break the line after a comma? 
> 
> I suggest using @tie{} between os (or program or ...) names and
> versions.  That way the line breaks come out ok in both the source and
> the output.

Indeed, the result looks better (at least in HTML). I tested

@item
This function is missing on some platforms:
address@hidden@tie{}10.5, address@hidden, address@hidden, address@hidden, 
address@hidden, address@hidden, address@hidden, address@hidden, 
address@hidden@tie{}2010-11, Cygwin, mingw, address@hidden, BeOS.

But it reduces the readability of the .texi file, leading to two problems
with the way I work currently:
  - Often I point people to the newest .texi files in the repository,
    because we update the documentation on www.gnu.org rather seldomly.
  - Often I copy&paste between these .texi files and email.

Hmm. What do the others think?

> Requiring manually broken source lines defeats M-x fill-paragraph.

Basically I was explaining to Eric that he should not use M-x fill-paragraph
on these paragraphs, because the result that M-x fill-paragraph produces
makes it more complicated to do mass modifications to 500 files at once.

> (Also, I suggest MacOSX or address@hidden instead of MacOS X, for
> precisely the reason you cite.)

address@hidden is fine with me *if* we decide to use it systematically.
I wouldn't want to have half of the spellings be "MacOS X" and the other
half "address@hidden".

Bruno
-- 
In memoriam The inmates of the Daugavpils Ghetto 
<http://en.wikipedia.org/wiki/Daugavpils_Ghetto>



reply via email to

[Prev in Thread] Current Thread [Next in Thread]