[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: [PATCH] Fix make in doc/ + directory restructuring

From: C. Michael Pilato <cmpilato_at_collab.net>
Date: 2005-03-15 00:45:58 CET

Øyvind A. Holm <sunny@sunbase.org> writes:

> A reminder of the patch I sent to the list at 2005-03-09 03:39:55Z about
> cleaning up /trunk/doc/Makefile after the svnbook moved. It's pretty
> uncontroversial:
>
> [[[
> Clean up doc/book/Makefile after the svnbook was moved out of the
> repository in r13125. It now builds misc-docs without errors.
>
> * doc/book/Makefile
> (Renamed variables):
> BOOK_TOP to DOC_TOP
> BOOK_HTML_XSLTPROC_OPTS to DOC_HTML_XSLTPROC_OPTS
> BOOK_PDF_XSLTPROC_OPTS to DOC_PDF_XSLTPROC_OPTS
> BOOK_PS_XSLTPROC_OPTS to DOC_PS_XSLTPROC_OPTS
> (Deleted variables): BOOK_HTML_CHUNK_DIR, BOOK_DIR, BOOK_HTML_TARGET,
> BOOK_HTML_CHUNK_TARGET, BOOK_PDF_TARGET, BOOK_PS_TARGET,
> BOOK_FO_TARGET, BOOK_XML_SOURCE, BOOK_VERSION_SOURCE,
> BOOK_ALL_SOURCE, BOOK_IMAGES, BOOK_INSTALL_DIR

These are keyed backwardly, I think:

   (DOC_TOP): Was BOOK_TOP.
   (DOC_HTML_XSLTPROC_OPTS): Was BOOK_HTML_XSLTPROC_OPTS.
   (DOC_PDF_XSLTPROC_OPTS): Was BOOK_PDF_XSLTPROC_OPTS.
   (DOC_PS_XSLTPROC_OPTS): Was BOOK_PS_XSLTPROC_OPTS.
   (BOOK_HTML_CHUNK_DIR, BOOK_DIR, BOOK_HTML_TARGET,
    BOOK_HTML_CHUNK_TARGET, BOOK_PDF_TARGET, BOOK_PS_TARGET,
    BOOK_FO_TARGET, BOOK_XML_SOURCE, BOOK_VERSION_SOURCE,
    BOOK_ALL_SOURCE, BOOK_IMAGES, BOOK_INSTALL_DIR): Removed.

> http://sunbase.org/src/subversion/patch/r13317.doc-Makefile.patch

Other than that, I'm fine with you committing this up.

> I would also suggest the following:
>
> 0. Move doc/book/misc-docs to the parent directory so it is easier to
> find.

+1

> 1. Merge the docs in doc/user/ into misc-docs. The documents in
> doc/users/ haven't been updated in almost a year, and it seems as
> some of the documentation there is duplicated both in misc-docs/
> and user/. And what's the difference between user/ and misc-docs/
> anyway?

So, IIRC, misc-docs came about simply because we wanted all the
Docbook XML documents in one place. Not sure why we felt this was
necessary, but whatever...

I don't think this merge is a necessary step at this time, or at
least, if we do a major doc re-org, we should take all things into
consideration, meaning that all our docs should probably go live in
docs/en/... (so that translations can live in docs/TRANSLATION/...)
and so on.

> 2. Merge changes from the Makefile in the svnbook repository, there
> are some interesting new stuff there, for example a couple of new
> scripts which should automate things a bit.

+1

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Tue Mar 15 00:50:20 2005

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.