Bug 62678 - SEE ALSO section absent from manpages
Summary: SEE ALSO section absent from manpages
Status: NEEDINFO
Alias: None
Product: Apache httpd-2
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 2.5-HEAD
Hardware: All All
: P2 normal (vote)
Target Milestone: ---
Assignee: HTTP Server Documentation List
URL:
Keywords:
Depends on:
Blocks: 58132
  Show dependency tree
 
Reported: 2018-09-05 09:39 UTC by Peter Oliver
Modified: 2019-01-04 12:35 UTC (History)
1 user (show)



Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Peter Oliver 2018-09-05 09:39:06 UTC
The XML source for the `httpd` manpage [contains serveral `seealso` tags ](https://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/httpd.xml?view=markup#l42), but these never make it into the [generated manpage](https://svn.apache.org/viewvc/httpd/httpd/trunk/docs/man/httpd.8?view=markup).

This makes the page confusing to read: the formatted page says, at one point, “See Stopping Apache httpd for more information”, but provides no indication of where this can be found.

Other pages, such as the one for `apachectl`, have the same problem.
Comment 1 Luis Gil de Bernabé P. 2019-01-04 12:35:12 UTC
this cause could be much likely that in the xml files are not included the <seealso> tag </seealso> at the summary section. so at the time the its the documents are built, if its not included in the xml it wont generate this secction on the documents.

on the other hand, we should first look at https://bz.apache.org/bugzilla/show_bug.cgi?id=58132

suggestions are welcome even corrections