Re: Missing and out-of-date information in guile.1, the Guile man page

[Andy Wingo <wingo@pobox.com>]

[-- Attachment #1: Type: text/plain, Size: 1577 bytes --]

Hi Mark,

I updated the man page.  I don't really know groff though, so please reply
with comments (text appended).

On Mon 17 Jan 2011 00:23, Mark Harig <idirectscm@aim.com> writes:

>  - There is no description in the Guile manual page,
>    guile.1, or the Guile Reference Manual, guile.info*, of
>    the environment variable GUILE_AUTO_COMPILE.

I think that's OK to not have it in the man page, though it should be in
the manual.  

>  - The reference manual also briefly mentions the
>    environment variable GUILE_HISTORY (it describes the
>    default value as `.guile_history', but does not mention
>    its default location, presumably $HOME, correct?), but
>    the manual page does not mention it.

Yes, it does put it in $HOME, though argually it should go in .local or
.cache or something.  

I'm also OK with the man page not mentioning this, FWIW.

>  - Is there an environment variable that can specify the
>    name of the Guile initialization file (default: .guile)?

Nope.  You can use -q and -l though.

>  - Are there any other environment variables that are not
>    documented in the Guile Reference Manual?

Yes.  Would you like to submit a patch documenting them?  Feel free to
ask on the list about what they mean, if the meanings are not clear :)

>  - For comparison, the Emacs manual includes a section
>    describing the environment variables that may effect it
>    when it is invoked.  See the Info node "(emacs)
>    Environment" (a subsection of the appendix "Invoking
>    Emacs").

Would be good to add to Guile as well.

Cheers,

Andy


[-- Attachment #2: guile.1 --]
[-- Type: application/x-troff-man, Size: 5408 bytes --]