On Fri, 2005-07-08 at 22:20 +0100, Stuart Ellis wrote:
> I've been using xml-normalize and also tidy-bowl locally, and they both
> seem to work perfectly :)
>> The first test document I used with tidy-bowl was edited with emacs/nxml
> and it realigned the text correctly. I also messed around with spacing
> and text alignment within xml-normalize.
I did some runs using ../docs-common/bin/tidy-bowl against the SELinux
FAQ, which I *believed* to be a shining example of correct indentation,
etc.
Apparently I have some extra whitespace in there. :) I also had to
reindent using the 72 characters width before running a meaningful diff.
http://people.redhat.com/kwade/fedora-docs/selinux-faq-post_tidy-bowl.diff
Every piece of that file had sgml-fill-element used (C-c C-q), save the
flush-left <screen> et al. I would have expected zero or a few
differences.
Let's look at the kind of diffs generated:
* Whitespace decisions -- that seems to come from "para normalize =
yes". I can accept that I have extraneous whitespace, and it was picked
up and fixed. That's good.
* Some tags have breaks before and after, perhaps meaning they are not
being recognized as inline. These include <ulink> and <abbrev>. I
suppose I should put a line in xmlformat-fdp.conf, except there is one
for <ulink> already to make it inline. Hmmm. I tried adding "entry-
break" and "exit-break" set to 0 for ulink, but it still makes line
breaks.
* A number of paragraphs appear to have been indented by a single space.
These might have been spaces-not-tabs indents that I didn't clean up
after I fixed my .emacs to stop doing that. I.e., I went back to using
tabs-as-tabs to match with the default Emacs install on Fedora Core, but
I may not have fixed up this document and it is using spaces-as-tabs.
* All of my double-spaces after periods have been replaced with single-
spaces. I thought that DocBook liked the double-space after a period?
Or am I just left in the typewriter age on that one?
On the whole, the document looks as if it is better and certainly more
normalized for the treatment. Hopefully my mysteries aren't that
mysterious.
- Karsten
--
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20050708/2b5918f2/attachment.bin