RE: Developer Documentation Info

[Nicola Pero]

Hi Marco,

1. the info files are installed in the path that you decide when you choose the
filesystem layout when you configure gnustep-make. ;-)

Check the filesystem layouts inside core/make/FilesystemLayouts/ (you are 
looking
for the keys 'GNUSTEP_SYSTEM_DOC_INFO', 'GNUSTEP_LOCAL_DOC_INFO', etc).  As you 
see
every layout installs the info files in a different place. :-)

If you're unhappy with the standard filesystem layouts, you can create your 
own! :-)

Eg, you can take the 'gnustep' one, edit the line GNUSTEP_SYSTEM_DOC_INFO 
/ GNUSTEP_LOCAL_DOC_INFO / etc to install your System/Local/etc info files 
somewhere else.  Then rename it to 'marco' or something like that, and configure
gnustep-make with ./configure --with-layout=marco and you're done. :-)

2. If you're using the standard GNUstep filesystem layout and you want the info
files installed into /System/Library/Documentation/info to appear in your
info/emacs readers, you should add these paths to INFOPATH.  If you source 
GNUstep.sh,
that will do it for you :-)

3. Check what is done when you install the info files by doing

 make install messages=yes

if you find the commands are unsatisfactory, we can change them.  The commands 
arrive
from core/make/Instance/Documentation/texi.make.  Feel free to experiment with 
changing
them and submit a patch! :-)

Yes, it would be very good to organize the gnustep info files in some nice way 
so you
can browse them nicely inside Emacs.  Feel free to suggest how to do that - 
I'll try to
help you make the appropriate changes to gnustep-make to support your solution.

4. I'm not sure why the documentation is not installed automatically.  It might 
be
because it's not built automatically ?  The texinfo documentation (eg, in 
gnustep-make)
requires texinfo to generate, and some people don't have it installed, which is 
why
it's not always regenerated.  One solution might be to include pre-generated 
documentation
with all packages ?  I think gnustep-make partially does this, but we could 
extend it.

Thanks



-----Original Message-----
From: "Marco (Bj) Bardelli" <address@hidden>
Sent: Tue, March 27, 2007 1:13 pm
To: address@hidden
Subject: Developer Documentation Info

Hi at all,
I have two questions ... Why , Documentation in core packages 
(make|base|gui|back) , is not
installed automatically ??
And, why the infos documentation also running 'make install' in Documentation 
die of each
packages, install the man|html|infos in dir under System domain but for the 
infos don't
install-info in /usr/share/info/ dir or other Directory info file ???
In Unix is enough standard dir info location ... (/usr/share/info or /usr/info 
... or
for unprivileged /usr/local ...)

My is only the question ... i could make a script that run install-info on 
files .info under
Documentation dir ... but is better integrate in GNUmakefile in Doc dirs ... or 
also in documentation.make.

Would be fantastic a menu :
GNUstep
* GNUstepBase
* ....

In info Emacs (C-h i) ...
Thanks
marco


_______________________________________________
Gnustep-dev mailing list
address@hidden
http://lists.gnu.org/mailman/listinfo/gnustep-dev