Ø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