23 Commits

Author SHA1 Message Date
Nicholas Nethercote
41876dfd59 Went over the FAQ. Also tweaked vg-entities.xml a bit.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@10732
2009-08-07 02:58:11 +00:00
Nicholas Nethercote
48152e7a48 Overhaul the BBV manual chapter, mostly. Also tweak BBV's usage message to
match the docs better.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@10724
2009-08-05 23:59:05 +00:00
Nicholas Nethercote
ac7761261a We currently use a mix of <option> and <computeroutput> tags for command
line options.  This commit changes them to all <option>.

Also make consistent how options with multiple names (eg. -h --help) are
shown.

Also, remove section describing --help and --version in Callgrind's chapter;
these aren't necessary and are presumably a hangover from when Callgrind was
a separate tool.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@10659
2009-07-30 02:57:52 +00:00
Nicholas Nethercote
78b2e5c83e Started overhauling the documentation:
- There were detailed descriptions of all the tools in the Quick Start
  Guide, the Manual introduction, and the start of each tool chapter.  To
  avoid duplication/overlap, I removed these altogether from the Quick Start
  Guide, and shortened them in the intro.

- Improved the description of what errors Memcheck can find.

- Made all tool chapters start with "Overview" section, for consistency.

- Made the "run with --tool=XXX" bit consistent in each tool chapter.

- Made all tool chapter titles match the description given when running them.

- Added BBV to the User Manual intro.

- Generally clarified, updated, and future-proofed various bits of text in
  the Quick Start Guide and User Manual introduction. 

Also:
- Changed Nulgrind's start-up description to "the minimal Valgrind tool".

- Fixed some punctuation in the usage message.


git-svn-id: svn://svn.valgrind.org/valgrind/trunk@10652
2009-07-29 02:36:21 +00:00
Julian Seward
c7d583fcbd Minor updates for 3.4.0. Also fix a large number of missing <para>
and </para> tags.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@8861
2008-12-22 01:00:15 +00:00
Julian Seward
8e8a7e5754 Very minor changes.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@7209
2007-11-25 00:56:51 +00:00
Julian Seward
9101880b1f Update documents in preparation for 3.3.0, and restructure them
somewhat to move less relevant material out of the way to some extent.
The main changes are:

* Update date and version info

* Mention other tools in the quick-start guide

* Document --child-silent-after-fork

* Rearrange order of sections in the Valgrind Core chapter, to move
  advanced stuff (client requests) to the end, and compact stuff
  relevant to the majority of users towards the front

* Move MPI debugging stuff from the Core manual (a nonsensical place
  for it) to the Memcheck chapter

* Update the manual's introductory chapter a bit

* Connect up new tech docs summary page, and disconnect old and
  very out of date valgrind/memcheck tech docs

* Add section tags to the Cachegrind manual, to stop xsltproc
  complaining about their absence



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@7199
2007-11-22 01:21:56 +00:00
Julian Seward
b91b51b42b Merge (from 3.2 branch) r6743 (Edit the manual to bring it up to date
and make some of the wording a bit more professional sounding.)



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@6745
2007-05-23 21:58:33 +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
Donna Robinson
569b58b383 Few more doc tweaks for consistency's sake
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@5205
2005-11-19 03:28:10 +00:00
Nicholas Nethercote
cc64c8dda4 Minor QSG tweaks.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@5200
2005-11-18 22:09:47 +00:00
Nicholas Nethercote
c3ffb5e7a4 wibble
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@5136
2005-11-15 20:16:45 +00:00
Julian Seward
86c998a8de Update manual for 3.1.0, sections <= manual-core.html.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@5135
2005-11-15 19:51:04 +00:00
Nicholas Nethercote
737ff99047 wibbles
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4788
2005-09-27 18:52:39 +00:00
Nicholas Nethercote
cd2e9fbe4b blah
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4423
2005-08-15 04:44:26 +00:00
Nicholas Nethercote
a754ffbee4 fix line numbers
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4422
2005-08-15 04:40:57 +00:00
Nicholas Nethercote
50898b4c82 foo
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4421
2005-08-15 04:37:34 +00:00
Nicholas Nethercote
5492bb9c86 some more info in the QSG
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4420
2005-08-15 04:34:20 +00:00
Nicholas Nethercote
1f14543221 Update docs for 3.0.0 release. Still to do: update command line options.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4246
2005-07-25 00:12:19 +00:00
Donna Robinson
ff4eb2863e mc-tech-docs.xml:
- fixed link to comply with house-style
mc-manual.xml:
- rm'd unhelpful sentence + it's footnote
quick-start-guide.xml:
- fixed up some section ids + xreflabels 
  so we don't get cool filenames like 'bk01s02.html'.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@3898
2005-06-12 10:23:23 +00:00
Nicholas Nethercote
c3187ad891 Added the Quick Start Guide, in XML. Not entirely happy with the formatting
(it should be all one page), but it's a start.



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@3270
2005-03-11 04:33:29 +00:00