Bug 125754 - <para> usage in example-tutorial-en.xml conflicts with Docs Guide
Summary: <para> usage in example-tutorial-en.xml conflicts with Docs Guide
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Fedora Documentation
Classification: Retired
Component: example-tutorial
Version: devel
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Tammy Fox
QA Contact: Tammy Fox
URL: http://fedora.redhat.com/participate/...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2004-06-10 20:55 UTC by Mark Johnson
Modified: 2007-04-18 17:08 UTC (History)
1 user (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2004-08-12 21:34:08 UTC
Embargoed:


Attachments (Terms of Use)

Description Mark Johnson 2004-06-10 20:55:36 UTC
Description of problem:

The Documentation Guide says:

"Additionally, the <para> tags should be justified around the
paragraph so that the opening <para> tag and the first word of that
paragraph are side by side. For example:


<para>This paragraph talk about using the <para> 
tag correctly.<para>"

But the example-tutorial-en.xml contains the following snippet:

    <para>
      This is an example section. You can also use sect1, sect2, etc.
    </para>

which contradicts what the Guide says.

Comment 1 Paul W. Frields 2004-07-30 22:33:07 UTC
Is there a reason why &lt;para&gt; tags have to be done in this way? I
find it easier to follow the markup (as an editor) when I see things
like the tutorial shows them. To me, the best possible situation would
be a single, uninterrupted "flow" of text that shifts indentation in
and out. I realize that the &lt;screen&gt; usage and a couple other
exceptions exist; not a problem.

More importantly, though, when one uses a block &lt;para&gt; it causes
Emacs/psgml to behave strangely when using M-q to fill. Maybe that's
bad Emacs usage; I'm an Emacs novice, so sue me. :-)

Comment 2 Karsten Wade 2004-08-02 22:54:56 UTC
Above behavior resolved using sgml-fill-paragraph (C-c C-q), when the
DTD has been properly parsed (C-c C-p).

FWIW, the process specified in the Documentation Guide is legacy
information and doesn't (likely) apply to the XML.

I'll grab this bug to fix when I get CVS access.

Comment 3 Tammy Fox 2004-08-12 21:34:08 UTC
It is legacy from the Documentation Guide we use for DocBook SGML. The
reason why this must be done is because having any space (carriage
return or blank spaces) after the &lt;para&gt; tag in DocBook SGML
causes a blank line in the PDF generated using DSSSL stylesheets. I
filed a bug on the DSSSL stylesheets for this but was told that it was
intended behavior and not a bug. So, to not get the blank line in the
PDF, we started this rule for &lt;para&gt; tags. I just tested it, and
it is not a problem with DocBook XML and XSL, so I am removing the
rule from the Docs Guide. (I never liked having to start the text
right after the tag either.)


Note You need to log in before you can comment on or make changes to this bug.