git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Craig Moore <craigtmoore@googlemail.com>
To: Michael J Gruber <git@drmicha.warpmail.net>
Cc: git@vger.kernel.org
Subject: Re: Trouble with 'make prefix=/usr info'
Date: Wed, 6 Jan 2010 13:32:03 +0100	[thread overview]
Message-ID: <d4133e471001060432v38a3f910qb27b9e77f4c1aa8b@mail.gmail.com> (raw)
In-Reply-To: <4B310054.4060900@drmicha.warpmail.net>

2009/12/22 Michael J Gruber <git@drmicha.warpmail.net>:
> Craig Moore venit, vidit, dixit 22.12.2009 17:14:
>> 2009/12/22 Michael J Gruber <git@drmicha.warpmail.net>:
>>> Craig Moore venit, vidit, dixit 22.12.2009 16:50:
>>>> 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

  reply	other threads:[~2010-01-06 12:32 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-12-22 15:50 Trouble with 'make prefix=/usr info' Craig Moore
2009-12-22 15:58 ` Michael J Gruber
2009-12-22 16:14   ` Craig Moore
2009-12-22 17:22     ` Michael J Gruber
2010-01-06 12:32       ` Craig Moore [this message]
2010-01-08 21:14         ` Chris Johnsen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=d4133e471001060432v38a3f910qb27b9e77f4c1aa8b@mail.gmail.com \
    --to=craigtmoore@googlemail.com \
    --cc=git@drmicha.warpmail.net \
    --cc=git@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).