Bug 221200 - Bad markup in system-config.services.8
Summary: Bad markup in system-config.services.8
Keywords:
Status: CLOSED RAWHIDE
Alias: None
Product: Fedora
Classification: Fedora
Component: system-config-services
Version: rawhide
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Nils Philippsen
QA Contact:
URL:
Whiteboard: bzcl34nup
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2007-01-02 22:30 UTC by Eric Raymond
Modified: 2008-04-04 11:38 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2008-04-04 11:38:22 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

Description Eric Raymond 2007-01-02 22:30:36 UTC
See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated.  Feel free to email me with any questions.
Note: These patches do not change the mod date of any manual page.  You
may wish to do that by hand.

Problems with system-config-services.8:

1. Use of low-level troff hackery to set special indents or breaks can't
be translated. The page will have rendering faults in HTML, and
probably also under third-party man page browsers such as Xman, TkMan,
Rosetta, and the KDE help browser.

2. SYNTAX section is actually a Unix SYNOPSIS and should be so marked.

--- system-config-services.8-orig	2007-01-02 17:24:34.000000000 -0500
+++ system-config-services.8	2007-01-02 17:25:18.000000000 -0500
@@ -1,7 +1,7 @@
 .TH serviceconf 8 "Wed May 16 2001"
 .SH "NAME"
 system-config-services \- Service Configuration Utility
-.SH "SYNTAX"
+.SH "SYNOPSIS"
 system-config-services
 .SH "DESCRIPTION"
 This is a graphical tool for enabling and disabling services
@@ -10,10 +10,10 @@
 .SH "OPTIONS"
 None
 .SH "FILES"
+.nf
 \fI/usr/bin/system-config-services\fP
-.br 
 \fI/usr/share/serviceconf/*\fP
-.br 
+.fi
 .SH "EXAMPLES"
 To run this program simply type:
 .LP 
@@ -40,8 +40,8 @@
 stopped, etc). This will be fixed; until then it's a bug.
 
 .SH "AUTHORS"
+.nf
 Tim Powers <timp>
-.br
 Bill Nottingham <notting>
-.br
 Dan Walsh <dwalsh>
+.fi
-----------------------------

Comment 1 Bug Zapper 2008-04-04 05:27:43 UTC
Fedora apologizes that these issues have not been resolved yet. We're
sorry it's taken so long for your bug to be properly triaged and acted
on. We appreciate the time you took to report this issue and want to
make sure no important bugs slip through the cracks.

If you're currently running a version of Fedora Core between 1 and 6,
please note that Fedora no longer maintains these releases. We strongly
encourage you to upgrade to a current Fedora release. In order to
refocus our efforts as a project we are flagging all of the open bugs
for releases which are no longer maintained and closing them.
http://fedoraproject.org/wiki/LifeCycle/EOL

If this bug is still open against Fedora Core 1 through 6, thirty days
from now, it will be closed 'WONTFIX'. If you can reporduce this bug in
the latest Fedora version, please change to the respective version. If
you are unable to do this, please add a comment to this bug requesting
the change.

Thanks for your help, and we apologize again that we haven't handled
these issues to this point.

The process we are following is outlined here:
http://fedoraproject.org/wiki/BugZappers/F9CleanUp

We will be following the process here:
http://fedoraproject.org/wiki/BugZappers/HouseKeeping to ensure this
doesn't happen again.

And if you'd like to join the bug triage team to help make things
better, check out http://fedoraproject.org/wiki/BugZappers

Comment 2 Nils Philippsen 2008-04-04 11:38:22 UTC
Sorry for the late response and thanks for the patch. I've fixed this and
updated the manpage in system-config-services-0.99.12 which is building right now.


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