Re: INSTALL nits

2023-08-20 Thread Paul Eggert
On 8/19/23 04:55, Gavin Smith wrote: I was concerned with the case of a person trying to read INSTALL in a non-UTF-8 terminal. This is possible with e.g. "LC_ALL=C xterm" or in some MS-Windows terminal windows. It's also possible with people running on a console that doesn't even support ASCI

Re: INSTALL nits

2023-08-19 Thread Gavin Smith
On Fri, Aug 18, 2023 at 10:02:53PM -0500, Paul Eggert wrote: > > It would make sense to use "INSTALL.ISO" > > as INSTALL in packages. > > In old-fashioned packages perhaps. Nowadays a lot of packages use UTF-8 in > their source files anyway. > > I understand the reluctance to go beyond ASCII. Lon

Re: INSTALL nits

2023-08-18 Thread Paul Eggert
On 8/17/23 06:47, Gavin Smith wrote: This is an improvement, but there are still a couple left (made with @ref). Thanks, fixed with the attached further patch. It would make sense to use "INSTALL.ISO" as INSTALL in packages. In old-fashioned packages perhaps. Nowadays a lot of packages us

Re: INSTALL nits

2023-08-18 Thread Russ Allbery
"Zack Weinberg" writes: > What are the most common things people need to do in a "bootstrap" > script that *aren't* covered by `autoreconf -i`? I'm not sure if this is the correct thing for me to do, but for years I've used the bootstrap script to do any pre-generation of files that I ship with

Re: INSTALL nits

2023-08-18 Thread Paul Eggert
On 8/17/23 09:41, Zack Weinberg wrote: What are the most common things people need to do in a "bootstrap" script that *aren't* covered by `autoreconf -i`? Some need to call autoreconf -i with other arguments, or run it multiple times. For example, Emacs runs 'autoreconf -fi -I m4' at the top

Re: INSTALL nits

2023-08-18 Thread Thomas Jahns
On Aug 17, 2023, at 15:41 , Zack Weinberg wrote: > What are the most common things people need to do in a "bootstrap" > script that *aren't* covered by `autoreconf -i`? in our package we apply some patches to libtool ltmain.sh, mostly for weirdnesses of commercial compilers. Thomas

Re: INSTALL nits

2023-08-17 Thread Peter Johansson
Hi Zack, On 17/8/23 23:41, Zack Weinberg wrote: On Thu, Aug 17, 2023, at 9:13 AM, Bob Friesenhahn wrote: On Thu, 17 Aug 2023, Gavin Smith wrote: Is there any consistency in naming across different packages, i.e. is "bootstrap" the most widely used name? No, there is no consistency across diff

Re: INSTALL nits

2023-08-17 Thread Zack Weinberg
On Thu, Aug 17, 2023, at 9:13 AM, Bob Friesenhahn wrote: > On Thu, 17 Aug 2023, Gavin Smith wrote: >> >> Is there any consistency in naming across different packages, i.e. >> is "bootstrap" the most widely used name? > > No, there is no consistency across different packages. If this was > part of

Re: INSTALL nits

2023-08-17 Thread Bob Friesenhahn
On Thu, 17 Aug 2023, Gavin Smith wrote: Is there any consistency in naming across different packages, i.e. is "bootstrap" the most widely used name? No, there is no consistency across different packages. If this was part of the GNU coding standards then perhaps actual GNU projects might be

Re: INSTALL nits

2023-08-17 Thread Gavin Smith
On Tue, Aug 15, 2023 at 07:01:42PM -0700, Paul Eggert wrote: > On 2023-08-14 11:01, Gavin Smith wrote: > > > It makes no sense to include the Info cross-reference beginning "*note" > > in a plain text file > > Thanks, fixed by installing the attached into Autoconf and propagating it > into Gnulib

Re: INSTALL nits

2023-08-15 Thread Paul Eggert
On 2023-08-14 11:01, Gavin Smith wrote: It makes no sense to include the Info cross-reference beginning "*note" in a plain text file Thanks, fixed by installing the attached into Autoconf and propagating it into Gnulib. Using ASCII quotes, like 'README', would be just as good here. I th

Re: INSTALL nits

2023-08-15 Thread Paul Eggert
On 2023-08-14 14:14, Bob Friesenhahn wrote: To me, an arbitrary bootstrap script is both a privacy and security hazard without the user carefully studying the design of the script. The same is true for ‘configure’, which is 2,182,586 bytes in my copy of coreutils. Or for Makefiles (even bigge

Re: INSTALL nits

2023-08-14 Thread Bob Friesenhahn
On Mon, 14 Aug 2023, Gavin Smith wrote: It seems that people are more likely to be have broken or unusual setups when reading an INSTALL file than when reading other text files, making UTF-8 more of a potential problem. * A "bootstrap" command is recommended as the first step: The followin

INSTALL nits

2023-08-14 Thread Gavin Smith
I'm writing about a few things I noticed in the INSTALL file that is often included at the top level of packages. A copy of this is kept in the gnulib repository, but as far as I can tell, the master is kept in autoconf. Please point me in the right direction if I'm writing to the wrong list. ht