26 Commits

Author SHA1 Message Date
Julian Seward
841265804c Don't hardwire the docbook version.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@6059
2006-09-12 22:36:55 +00:00
Julian Seward
06f53b15e8 Now that the man page is built from the XML documentation masters, it
has to have the same status as the HTML/PDF/PS docs, that is, not
built by default because it depends on the ultra-fragile XML
toolchain.  So make it use the same hacks, that is, build only at
'make dist' time.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@5279
2005-12-04 15:00:06 +00:00
Donna Robinson
e53a6fba14 The valgrind manpage is now auto-generated directly from the
*.xml docs.  No more groffly/nroffly editing.
How cool is docbook ?



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@5276
2005-12-03 22:33:29 +00:00
Donna Robinson
c2aa0a5eea Post-release changes:
- removed a reference to cachegrind dot org from mc-tech-docs.xml
- in an effort to simplify future borked links, replaced all valgrind 
  website urls with entities so now we just have to change one string.
- new stylesheet to create the docs to 'fit' into the website
- added build rules 'make website-docs' + make download-docs
  to /docs/Makefile.am




git-svn-id: svn://svn.valgrind.org/valgrind/trunk@5239
2005-11-27 04:10:00 +00:00
Donna Robinson
2022dbf52c Due to package upgrades (docbook, passivetex), removed some
bug-patches and created some new ones in the stylesheets.
Also tweaked some files to structure the xml properly.
The FAQ and the Quick-Start are now 'articles' inside a book-wrapper,
which is as it should be.

FAQ.xml
- due to various passivetex bug fixes, the faq is now a properly 
  structured xml qandaset document

quick-start-guide.xml:
manual.xml
- Fixed some passivetex-workaround kludges:
  legalnotice -> author

manual-core.xml:
For readability, added '<command>' to varlistentry items 
since passivetex (sigh) will no longer indent the para text.

index.xml:
- loads of white-space readability tweaks here and there.

tech-docs.xml
dist-docs.xml
manual.xml
- additional entries to <bookinfo> for compatability with
  the rest of the docs.

/docs/Makefile.am
- added stuff to use the new vg-faq2txt.xsl stylesheet

/docs/lib/Makefile.am
- updated to reflect current contents of /docs/lib/
- removed refs to vg-html-single as is never ever used

/docs/lib/vg-fo.xsl
- massively updated to reflect losing old bugs and gaining new ones

/docs/lib/vg-common.xsl
- deleted as only contained two lines common to html and fo,
  so not worth the bother of hauling around

/docs/lib/vg-html-chunk.xsl
- added what was in vg-common.xsl

/docs/lib/line-wrap.xsl
/docs/lib/faq2text.xsl
- two new stylesheet files for transforming FAQ.xml to FAQ.txt



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@5234
2005-11-25 05:36:48 +00:00
Julian Seward
dd977b0ffa If pdfxmltex bombs, as it so often does, at least cause the build to
come to a halt rather than just hanging.


git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4975
2005-11-01 03:08:41 +00:00
Nicholas Nethercote
1805172055 whoops
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4833
2005-09-30 02:17:40 +00:00
Nicholas Nethercote
e41c7abfe2 Commit Jeroen Witmond's xml-to-text translator, and use it for the FAQ.
Less double maintenance, hoorah!



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4830
2005-09-30 01:43:32 +00:00
Nicholas Nethercote
cd5e4b47db Fix "make distcheck".
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4633
2005-09-13 04:10:45 +00:00
Julian Seward
d9135e872b In the final install, copy the documentation .pdf/.ps to files with a
bit of a more sensible name.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4262
2005-07-25 23:36:58 +00:00
Julian Seward
104ccad880 Build the .ps/.pdf documentation by default when doing 'make dist'.
Because this means installing lots of XML processing tools and
supporting gunk, there is a hack at the top of docs/Makefile.am for
disabling the .pdf/.ps build.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4257
2005-07-25 23:01:43 +00:00
Nicholas Nethercote
d0aac31dac Make it more obvious if something fails when making HTML or PS/PDF docs.
Also put the output of all pfdxmltex runs in the logfile, not just the
last run's output.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4255
2005-07-25 21:12:40 +00:00
Julian Seward
00c4434760 I think && might be a better statement-joiner than ; -- the pdfxmltex
runs can easily die silently.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4252
2005-07-25 17:53:46 +00:00
Nicholas Nethercote
61448c507d We have a nice little collection of text files describing various high
level things.  But they're all over the place.  This commits moves
them all to the new docs/internals/ directory, and gives them 
a consistent naming scheme.




git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4196
2005-07-19 21:46:19 +00:00
Dirk Mueller
7e74189e60 allow to be build in a buildroot
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4171
2005-07-18 23:56:46 +00:00
Julian Seward
fbaa77af8c Remove trailing slash (some part of the autoswamp didn't like it)
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4093
2005-07-03 00:50:48 +00:00
Nicholas Nethercote
fbf8653c8b Removed the remnants of the attempt at an ARM port, because it had
bit-rotted badly and was clogging up the code.

I put the useful remnants in docs/porting-to-ARM in case anyone ever
wants to try porting to ARM again.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4092
2005-07-02 23:13:59 +00:00
Nicholas Nethercote
e11bfa612d Add what I think is needed for the man page in the Makefile.am.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@3317
2005-03-12 21:06:06 +00:00
Nicholas Nethercote
f14fd8b2a1 Added a short document about how to port to a new arch or OS.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@3170
2004-11-30 19:27:02 +00:00
Nicholas Nethercote
f6ce991fe4 Fix PS/PDF generation somewhat; the Makefile syntax errors are now
fixed, although latex now runs out of memory when doing it.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@3159
2004-11-30 14:05:38 +00:00
Nicholas Nethercote
86e69e77cd Minor docs building fix.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@3154
2004-11-30 11:10:01 +00:00
Nicholas Nethercote
7a75a9f583 Overhauled the docs. Removed all the HTML files, put in XML files as
converted by Donna.  Hooked it into the build system so they are only
built when specifically asked for, and when doing "make dist".

They're not perfect;  in particular, there are the following problems:
- The plain-text FAQ should be built from FAQ.xml, but this is not
  currently done.  (The text FAQ has been left in for now.)

- The PS/PDF building doesn't work -- it fails with an incomprehensible
  error message which I haven't yet deciphered.

Nonetheless, I'm putting it in so others can see it.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@3153
2004-11-30 10:43:45 +00:00
Nicholas Nethercote
0db27515b1 Putting "dist_" in front of a "_DATA" variable means it is included in "make
dist".  This avoids the need to put it in "EXTRA_DIST", and saves a few lines
in all the docs Makefile.am files.


git-svn-id: svn://svn.valgrind.org/valgrind/trunk@2614
2004-08-25 11:40:07 +00:00
Julian Seward
5fd0ef7ca3 Just call me Mr Brain-Dead Moron. Move the documentation sources to
where I _should_ have put them in the first place, and fix up the
Makefile.am's accordingly.  'make' and 'make install' now work.


git-svn-id: svn://svn.valgrind.org/valgrind/trunk@1292
2002-11-13 21:24:57 +00:00
Nicholas Nethercote
8291bb8643 Removed files that are now elsewhere (in core/docs/ and memcheck/docs/),
setup basic skeleton linking to core + skin docs.


git-svn-id: svn://svn.valgrind.org/valgrind/trunk@1096
2002-09-23 13:10:54 +00:00
Julian Seward
72a784f3b1 Initial revision
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@2
2002-03-22 01:27:54 +00:00