Re: Trouble with 'make prefix=/usr info'

2009/12/22 Michael J Gruber [off-list ref]:

Craig Moore venit, vidit, dixit 22.12.2009 17:14:

quoted

2009/12/22 Michael J Gruber [off-list ref]:

quoted

Craig Moore venit, vidit, dixit 22.12.2009 16:50:

quoted

Hi,

I'm getting the following error when I make the info target:

$ make prefix=/usr info
make -C Documentation info
make[1]: Entering directory `/local/software/git-1.6.5.7/Documentation'
make[2]: Entering directory `/local/software/git-1.6.5.7'
make[2]: `GIT-VERSION-FILE' is up to date.
make[2]: Leaving directory `/local/software/git-1.6.5.7'
    DB2TEXI user-manual.texi
Usage: jw [<options>] <sgml_file>
where <options> are:
  -f|--frontend <frontend>:      Specify the frontend (source format)
                                 (default is docbook)
  -b|--backend <backend>:        Specify the backend (destination format)
                                 (default is html)
  -c|--cat <file>:               Specify an extra SGML open catalog
  -n|--nostd:                    Do not use the standard SGML open catalogs
  -d|--dsl <file>|default|none:  Specify an alternate style sheet
                                 (default is to use the default stylesheet)
  -l|--dcl <file>:               Specify an alternate SGML declaration
                                 (usual ones like xml.dcl get detected
automatically)
  -s|--sgmlbase <path>:          Change base directory for SGML distribution
                                 (usually /usr/share/sgml)
  -p|--parser <program>:         Specify the parser if several are installed
                                  (jade or openjade)
  -o|--output <directory>:       Set output directory
  -u|--nochunks:                 Output only one big file
                                 (overrides the stylesheet settings)
  -i|--include <section>:        Specify a SGML marked section to include
                                 (should be marked as "ignore" in the SGML text)
  -w|--warning <warning_type>|list: Control warnings or display the allowed
warning types
  -e|--errors <error_type>|list: Control errors or display the allowed error types
  -h|--help:                     Print this help message and exit
  -V <variable[=value]>:         Set a variable
  -v|--version:                  Print the version and exit
make[1]: *** [user-manual.texi] Error 1
make[1]: Leaving directory `/local/software/git-1.6.5.7/Documentation'
make: *** [info] Error 2

I can see that the error is likely related to the fact that it enters the
Documentation directing, then exits the Documentation directory, and then tries
to build the user-manual.texi file in the root directory (however, that file is
in the Documentation directory, which it just left). I've tried to track down
and change where it exits the Documentation directory, but I've had no success.

I would appreciate any recommendations you might have. I've already been able to
install git, but I couldn't install the 'info' target because of this error.

Does it work without prefix?
Also, you may want to cd into Documentation and try to make there.

Michael

Hey Michael,

Here is what happens when I run it inside the Documentation directory
(without the prefix):

user@server: /local/software/git-1.6.5.7/Documentation
$ make info
    SUBDIR ../
make[1]: `GIT-VERSION-FILE' is up to date.
    DB2TEXI user-manual.texi
Usage: jw [<options>] <sgml_file>
where <options> are:
  -f|--frontend <frontend>:      Specify the frontend (source format)
                                 (default is docbook)
  -b|--backend <backend>:        Specify the backend (destination format)
                                 (default is html)
  -c|--cat <file>:               Specify an extra SGML open catalog
  -n|--nostd:                    Do not use the standard SGML open catalogs
  -d|--dsl <file>|default|none:  Specify an alternate style sheet
                                 (default is to use the default stylesheet)
  -l|--dcl <file>:               Specify an alternate SGML declaration
                                 (usual ones like xml.dcl get detected
automatically)
  -s|--sgmlbase <path>:          Change base directory for SGML distribution
                                 (usually /usr/share/sgml)
  -p|--parser <program>:         Specify the parser if several are installed
                                  (jade or openjade)
  -o|--output <directory>:       Set output directory
  -u|--nochunks:                 Output only one big file
                                 (overrides the stylesheet settings)
  -i|--include <section>:        Specify a SGML marked section to include
                                 (should be marked as "ignore" in the SGML text)
  -w|--warning <warning_type>|list: Control warnings or display the
allowed warning types
  -e|--errors <error_type>|list: Control errors or display the allowed
error types
  -h|--help:                     Print this help message and exit
  -V <variable[=value]>:         Set a variable
  -v|--version:                  Print the version and exit
make: *** [user-manual.texi] Error 1

The first thing it does is go to the directory above, weird.

Craig

I think it only looks like that. SUBDIR processing is finished at that
point, and the DB2TEXI line is where user-manual.texi is actually being
processed, and that's what's causing the error. Did you set the texinfo
processor in the Makefile or using variables?

V=1 make info

will show you the exact commands being executed.

Michael

Michael, thanks for your reply, and happy 2010. I'm back in the
office, and here's what is returned when I execute the command:

================================
$ V=1 make info
make -C Documentation info
make[1]: Entering directory `/local/software/git-1.6.5.7/Documentation'
make -C ../  GIT-VERSION-FILE
make[2]: Entering directory `/local/software/git-1.6.5.7'
make[2]: `GIT-VERSION-FILE' is up to date.
make[2]: Leaving directory `/local/software/git-1.6.5.7'
rm -f user-manual.texi+ user-manual.texi && \
        docbook2x-texi user-manual.xml --encoding=UTF-8 --to-stdout

user-manual.texi++ && \

        /usr/bin/perl fix-texi.perl <user-manual.texi++ >user-manual.texi+ && \
        rm user-manual.texi++ && \
        mv user-manual.texi+ user-manual.texi
Usage: jw [<options>] <sgml_file>
where <options> are:
  -f|--frontend <frontend>:      Specify the frontend (source format)
                                 (default is docbook)
  -b|--backend <backend>:        Specify the backend (destination format)
                                 (default is html)
  -c|--cat <file>:               Specify an extra SGML open catalog
  -n|--nostd:                    Do not use the standard SGML open catalogs
  -d|--dsl <file>|default|none:  Specify an alternate style sheet
                                 (default is to use the default stylesheet)
  -l|--dcl <file>:               Specify an alternate SGML declaration
                                 (usual ones like xml.dcl get detected
automatically)
  -s|--sgmlbase <path>:          Change base directory for SGML distribution
                                 (usually /usr/share/sgml)
  -p|--parser <program>:         Specify the parser if several are installed
                                  (jade or openjade)
  -o|--output <directory>:       Set output directory
  -u|--nochunks:                 Output only one big file
                                 (overrides the stylesheet settings)
  -i|--include <section>:        Specify a SGML marked section to include
                                 (should be marked as "ignore" in the SGML text)
  -w|--warning <warning_type>|list: Control warnings or display the
allowed warning types
  -e|--errors <error_type>|list: Control errors or display the allowed
error types
  -h|--help:                     Print this help message and exit
  -V <variable[=value]>:         Set a variable
  -v|--version:                  Print the version and exit
make[1]: *** [user-manual.texi] Error 1
make[1]: Leaving directory `/local/software/git-1.6.5.7/Documentation'
make: *** [info] Error 2
================================

I've isolated the problem, and its coming from this command:

================================
$ docbook2x-texi user-manual.xml --encoding=UTF-8 --to-stdout

user-manual.texi++

Usage: jw [<options>] <sgml_file>
where <options> are:
  -f|--frontend <frontend>:      Specify the frontend (source format)
                                 (default is docbook)
  -b|--backend <backend>:        Specify the backend (destination format)
                                 (default is html)
  -c|--cat <file>:               Specify an extra SGML open catalog
  -n|--nostd:                    Do not use the standard SGML open catalogs
  -d|--dsl <file>|default|none:  Specify an alternate style sheet
                                 (default is to use the default stylesheet)
  -l|--dcl <file>:               Specify an alternate SGML declaration
                                 (usual ones like xml.dcl get detected
automatically)
  -s|--sgmlbase <path>:          Change base directory for SGML distribution
                                 (usually /usr/share/sgml)
  -p|--parser <program>:         Specify the parser if several are installed
                                  (jade or openjade)
  -o|--output <directory>:       Set output directory
  -u|--nochunks:                 Output only one big file
                                 (overrides the stylesheet settings)
  -i|--include <section>:        Specify a SGML marked section to include
                                 (should be marked as "ignore" in the SGML text)
  -w|--warning <warning_type>|list: Control warnings or display the
allowed warning types
  -e|--errors <error_type>|list: Control errors or display the allowed
error types
  -h|--help:                     Print this help message and exit
  -V <variable[=value]>:         Set a variable
  -v|--version:                  Print the version and exit

$ docbook2x-texi --version
DocBook-utils version 0.6.14 (jw version 1.1)
================================

As you can see, I'm using DocBook-utils version 0.6.14 (jw version
1.1), and it doesn't list '--encoding=UTF-8 --to-stdout' in its
options list. I'm guessing I've got the wrong version or type
installed? Is there another which I should be using?

Thanks for your help,
Craig