Re: What happened to INSTALL.txt?
But configure and INSTALL.txt aren't in git. They're created by autogen.sh. --- Knute Snortum (via Gmail) On Thu, Jul 30, 2020 at 2:18 PM H. S. Teoh wrote: > On Thu, Jul 30, 2020 at 10:05:27PM +0100, antlists wrote: > > On 30/07/2020 17:25, H. S. Teoh wrote: > > > On Mon, Jul 27, 2020 at 08:30:34AM -0700, Knute Snortum wrote: > > > > Well it looks like README.git should just contain this: > > > > Instructions for compiling LilyPond from source files can be > > > > found online at: > > > > > > > > [1] > https://lilypond.org/doc/v2.21/Documentation/contributor/index_17#Compiling > > > > > > Sounds like a good idea. > > > > > Does it? You're assuming internet access ... :-( > > > > Okay, most people will have it, but not all, and if all it needs is to > > run ./configure, then that's what should be in README.git. > [...] > > Yeah, assuming internet access is not so nice. README.git should at > least contain enough information to get INSTALL.txt generated without > needing online access, so that if you were to, hypothetically, get stuck > on a desert island without an internet connection (but somehow still > have your PC with you and a power source for it), you could in theory > compile a fresh checkout of lilypond. > > > T > > -- > Debugging is twice as hard as writing the code in the first place. > Therefore, if you write the code as cleverly as possible, you are, by > definition, not smart enough to debug it. -- Brian W. Kernighan > >
Re: What happened to INSTALL.txt?
On Thu, Jul 30, 2020 at 10:05:27PM +0100, antlists wrote: > On 30/07/2020 17:25, H. S. Teoh wrote: > > On Mon, Jul 27, 2020 at 08:30:34AM -0700, Knute Snortum wrote: > > > Well it looks like README.git should just contain this: > > > Instructions for compiling LilyPond from source files can be > > > found online at: > > > > > > > > > [1]https://lilypond.org/doc/v2.21/Documentation/contributor/index_17#Compiling > > > > Sounds like a good idea. > > > Does it? You're assuming internet access ... :-( > > Okay, most people will have it, but not all, and if all it needs is to > run ./configure, then that's what should be in README.git. [...] Yeah, assuming internet access is not so nice. README.git should at least contain enough information to get INSTALL.txt generated without needing online access, so that if you were to, hypothetically, get stuck on a desert island without an internet connection (but somehow still have your PC with you and a power source for it), you could in theory compile a fresh checkout of lilypond. T -- Debugging is twice as hard as writing the code in the first place. Therefore, if you write the code as cleverly as possible, you are, by definition, not smart enough to debug it. -- Brian W. Kernighan
Re: What happened to INSTALL.txt?
On 30/07/2020 17:25, H. S. Teoh wrote: On Mon, Jul 27, 2020 at 08:30:34AM -0700, Knute Snortum wrote: Well it looks like README.git should just contain this: Instructions for compiling LilyPond from source files can be found online at: [1]https://lilypond.org/doc/v2.21/Documentation/contributor/index_17#Compiling Sounds like a good idea. Does it? You're assuming internet access ... :-( Okay, most people will have it, but not all, and if all it needs is to run ./configure, then that's what should be in README.git. Chers, Wol
Re: What happened to INSTALL.txt?
On Mon, Jul 27, 2020 at 08:30:34AM -0700, Knute Snortum wrote: >Well it looks like README.git should just contain this: >Instructions for compiling LilyPond from source files can be found >online at: > > > > [1]https://lilypond.org/doc/v2.21/Documentation/contributor/index_17#Compiling Sounds like a good idea. T -- There are two ways to write error-free programs; only the third one works.
Re: What happened to INSTALL.txt?
Well it looks like README.git should just contain this: Instructions for compiling LilyPond from source files can be found online at: https://lilypond.org/doc/v2.21/Documentation/contributor/index_17#Compiling --- Knute Snortum (via Gmail) On Sun, Jul 26, 2020 at 7:43 AM Werner LEMBERG wrote: > > >> Seems to me like kind of a chicken-and-egg problem, though. In > >> order to build lilypond I need to read INSTALL.txt, but in order to > >> read INSTALL.txt, I need to build lilypond first... I ended up > >> googling for the file on the website and following the steps from > >> there instead. > > > > What about a README.txt file that says, "Run configure"? > > I think the normal way is to have a `README.git` file that contains > the necessary first steps to build from the repository, and people > should then continue with reading `README.txt` after it has been > created. > > > Werner >
Re: What happened to INSTALL.txt?
>> Seems to me like kind of a chicken-and-egg problem, though. In >> order to build lilypond I need to read INSTALL.txt, but in order to >> read INSTALL.txt, I need to build lilypond first... I ended up >> googling for the file on the website and following the steps from >> there instead. > > What about a README.txt file that says, "Run configure"? I think the normal way is to have a `README.git` file that contains the necessary first steps to build from the repository, and people should then continue with reading `README.txt` after it has been created. Werner
Re: What happened to INSTALL.txt?
What about a README.txt file that says, "Run configure"? --- Knute Snortum (via Gmail) On Sat, Jul 25, 2020 at 9:25 AM H. S. Teoh wrote: > On Sat, Jul 25, 2020 at 09:47:16AM +0200, Jonas Hahnfeld wrote: > > Hi, > > > > Am Freitag, den 24.07.2020, 15:14 -0700 schrieb H. S. Teoh: > > > I pulled lilypond sources from git today, and while trying to figure > > > out a botched configure invocation, I did a git clean -x -f, and now > > > INSTALL.txt doesn't exist anymore...? I did a fresh git clone from > > > git://git.sv.gnu.org/lilypond.git but same thing, INSTALL.txt seems > > > to have gone missing? > > > > INSTALL.txt is not tracked in git, but generated from texinfo sources > > when running ./configure (or ./autogen.sh). For that reason, it was > > removed with git-clean. > [...] > > Ah, thanks! That explains it. > > Seems to me like kind of a chicken-and-egg problem, though. In order to > build lilypond I need to read INSTALL.txt, but in order to read > INSTALL.txt, I need to build lilypond first... I ended up googling for > the file on the website and following the steps from there instead. > > > T > > -- > Тише едешь, дальше будешь. > >
Re: What happened to INSTALL.txt?
On Sat, Jul 25, 2020 at 09:47:16AM +0200, Jonas Hahnfeld wrote: > Hi, > > Am Freitag, den 24.07.2020, 15:14 -0700 schrieb H. S. Teoh: > > I pulled lilypond sources from git today, and while trying to figure > > out a botched configure invocation, I did a git clean -x -f, and now > > INSTALL.txt doesn't exist anymore...? I did a fresh git clone from > > git://git.sv.gnu.org/lilypond.git but same thing, INSTALL.txt seems > > to have gone missing? > > INSTALL.txt is not tracked in git, but generated from texinfo sources > when running ./configure (or ./autogen.sh). For that reason, it was > removed with git-clean. [...] Ah, thanks! That explains it. Seems to me like kind of a chicken-and-egg problem, though. In order to build lilypond I need to read INSTALL.txt, but in order to read INSTALL.txt, I need to build lilypond first... I ended up googling for the file on the website and following the steps from there instead. T -- Тише едешь, дальше будешь.
Re: What happened to INSTALL.txt?
Hi, Am Freitag, den 24.07.2020, 15:14 -0700 schrieb H. S. Teoh: > I pulled lilypond sources from git today, and while trying to figure out > a botched configure invocation, I did a git clean -x -f, and now > INSTALL.txt doesn't exist anymore...? I did a fresh git clone from > git://git.sv.gnu.org/lilypond.git but same thing, INSTALL.txt seems to > have gone missing? INSTALL.txt is not tracked in git, but generated from texinfo sources when running ./configure (or ./autogen.sh). For that reason, it was removed with git-clean. Jonas signature.asc Description: This is a digitally signed message part
