Hi Troels,
You should really discuss such large changes on the relax-devel
mailing list first before making them. Firstly, large rearrangements
like that need to happen in the trunk, not in the branches. As this
affects the layout in the trunk and all branches, and the change is
large, it will make it close to impossible to merge the branch back.
I know this from much experience with the old relax branches, and it
causes a lot of pain. Secondly, such large changes to get one chapter
of the manual to compile is not necessary. You can simply copy the
relax.tex file to a temporary, out of repository file and delete
almost everything but that one chapter - this is just for quick
testing anyway. Thirdly all the new files need to be created with an
'svn cp relax.tex new_file.tex' command to preserve their history so
that their evolution can be followed and studied. Git or git-svn will
not do this (see http://markpasc.livejournal.com/186489.html for a
good summary).
As for the changes themselves, I agree with some but not others. The
title page, abbreviations, and indexing could go into separate files -
this would be a good change and would make the main LaTeX document
cleaner. But all the LaTeX definitions, the document layout commands
\tableofcontents, \listoffigures, \listoftables and \printindex, and
chapter layout should be in the main LaTeX document. This is standard
for LaTeX. The \usepackage and \newcommand statements really must be
in the main file! The proper way to eliminate most of the preamble in
the main LaTeX file is to create a special .sty file. I.e. you write
a package for the relax manual. It is not to put it into a separate
file as this can cause clashes with some of the included LaTeX
packages. It is dangerous. I however don't think it is worth the
effort of creating this sty package file, as you can just use an out
of repository file to build a PDF file with just one chapter to
quickly achieve your aim.
Regards,
Edward
On 12 September 2013 08:00, Troels E. Linnet
<NO-REPLY.INVALID-ADDRESS@xxxxxxx> wrote:
Follow-up Comment #84, sr #3071 (project relax):
Patches for manual added.
The preamble settings, the frontpage and frontmatter, and appendix has been
moved into separate files.
This was to facilitate efficient use of includeonly
so compilation was only performed on the dispersion file, and with use of
pdflatex instead of latex.
The compilation time with pdflatex on dispersion chapter now only, takes 2-3
seconds.
When using pdflatex, Texmaker can also use the internal pdfviewer, with
auto-jumping from latex line to pdf, and the possibility to right-click in
pdf
and jump back to line.
(file #18974)
_______________________________________________________
Additional Item Attachment:
File name: Tollinger_manual.patch.tar.gz Size:18 KB
_______________________________________________________
Reply to this item at:
<http://gna.org/support/?3071>
_______________________________________________
Message sent via/by Gna!
http://gna.org/
_______________________________________________
relax (http://www.nmr-relax.com)
This is the relax-devel mailing list
relax-devel@xxxxxxx
To unsubscribe from this list, get a password
reminder, or change your subscription options,
visit the list information page at
https://mail.gna.org/listinfo/relax-devel
Re: [sr #3071] Implementation of Tollinger/Kay dispersion model (2001)