[Lilypond-auto] Issue 2558 in lilypond: Documentation suggestion: Including LilyPond files

[lilypond]

Status: Accepted
Owner: ----
Labels: Type-Documentation

New issue 2558 by address@hidden: Documentation suggestion: Including  
LilyPond files
http://code.google.com/p/lilypond/issues/detail?id=2558

Urs Liska sent in a documentation suggestion:

http://lists.gnu.org/archive/html/bug-lilypond/2012-05/msg00140.html

Quoting Urs:

I think I stumbled over a bit of misleading or wrong information in the NR.

Please have a look at the following documentation suggestion and  
incorporate it into the NR if you find it correct:

#############

in

3.3.1 Including LilyPond files

fifth paragraph (starting with "Files which are to be include")

change

" ... (or by adding |#(ly:set-option 'relative-includes #t)| at the top of  
the main input file)"

to

" ... (or by adding |#(ly:set-option 'relative-includes #t)| at the top of  
the main input file or of a file that is included from the main input file)"


################

You don't have to set the relative option in the main input file. This also  
works if it is placed in the included file. Use: If I have an include file  
which is an entry point for a library (i.e. includes other files on its  
own), I can define the relative-includes command in the library file, so I  
don't have to expect the 'user' to do it in each main input file.

Best
Urs