Adding to general-docs package

"Stephen J. Turnbull" <[email protected]> Sat, 30 Oct 2004 01:51:44 +0900
Newsgroups gmane.emacs.xemacs.design,gmane.emacs.xemacs.beta
Organization The XEmacs Project
Message-ID <[email protected]>
First, kudos to whoever was responsible for setting up general-docs
(Ville, Steve, Norbert?)---I dropped a file into the obvious place,
made the Makefile change suggested by the comment, "make install", and
what to my wondering eyes should appear but docs in the right place
that XEmacs's info reader picked up properly.

I'm wondering why the hierarchy is set up as

general-docs -+- (various)
              |
              +- texi -+- packages
                       |
                       +- xemacs

As I understand it, placement of the info files in the Info menu is
governed by the info directory and the @direntry and @dircategory
commands in the Texinfo source.  So the separation into packages and
xemacs seems a little pointless.

On the other hand, licensing of docs is an annoyance and likely to get
more so over time.  To keep things straight, I propose a hierarchy
based on licensing terms:

general-docs -+- (various)
              |
              +- texi -+- permissive
                       |
                       +- xemacs
                       |
                       +- gpl
                       |
                       +- gfdl
                       |
                       +- other-incompatible

or something like that.  (Permissive is MIT/BSD/Artistic/Python/....)

The documentation I plan to submit is fontconfig.texi, which is based
on Keith Packard's permissively licensed documents, and I'd like it to
stay that way as much as possible.

For my own use I've got fontconfig in the XEmacs section so that it's
at the top of Info dir node.  I'm thinking that maybe it's a good idea
to have an XEmacs Developer section and put it there.  Comments,
questions?

Reply-To set to xemacs-design.

-- 
Institute of Policy and Planning Sciences     http://turnbull.sk.tsukuba.ac.jp
University of Tsukuba                    Tennodai 1-1-1 Tsukuba 305-8573 JAPAN
               Ask not how you can "do" free software business;
              ask what your business can "do for" free software.