[
https://issues.apache.org/jira/browse/TS-3517?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14491708#comment-14491708
]
Leif Hedstrom commented on TS-3517:
-----------------------------------
It might be a good idea to maybe get this done for 6.0.0, since it'll change
the distribution set of files.
> Combine various man page docs files into "grouped" files
> --------------------------------------------------------
>
> Key: TS-3517
> URL: https://issues.apache.org/jira/browse/TS-3517
> Project: Traffic Server
> Issue Type: Improvement
> Components: Documentation
> Reporter: Leif Hedstrom
> Fix For: 6.0.0, Docs
>
>
> The intent, as far I used to know things, was that we'd group APIs by
> functionality, such that all *Debug* APIs goes into TSDebug.en.rst. This is
> the case for some APIs, but we now also have a *lot* of files (> 100) which
> only contains a single API. A good example is
> {code}
> doc/reference/api/TSMimeHdrFieldAppend.en.rst
> doc/reference/api/TSMimeHdrFieldClone.en.rst
> doc/reference/api/TSMimeHdrFieldCopy.en.rst
> doc/reference/api/TSMimeHdrFieldCopyValues.en.rst
> doc/reference/api/TSMimeHdrFieldCreate.en.rst
> doc/reference/api/TSMimeHdrFieldDestroy.en.rst
> doc/reference/api/TSMimeHdrFieldFind.en.rst
> doc/reference/api/TSMimeHdrFieldGet.en.rst
> doc/reference/api/TSMimeHdrFieldLengthGet.en.rst
> doc/reference/api/TSMimeHdrFieldNameGet.en.rst
> doc/reference/api/TSMimeHdrFieldNameSet.en.rst
> doc/reference/api/TSMimeHdrFieldNext.en.rst
> doc/reference/api/TSMimeHdrFieldNextDup.en.rst
> doc/reference/api/TSMimeHdrFieldRemove.en.rst
> doc/reference/api/TSMimeHdrFieldValueAppend.en.rst
> doc/reference/api/TSMimeHdrFieldValueDateInsert.en.rst
> doc/reference/api/TSMimeHdrFieldValueDateSet.en.rst
> doc/reference/api/TSMimeHdrFieldValueIntSet.en.rst
> doc/reference/api/TSMimeHdrFieldValueStringGet.en.rst
> doc/reference/api/TSMimeHdrFieldValueStringInsert.en.rst
> doc/reference/api/TSMimeHdrFieldValueStringSet.en.rst
> doc/reference/api/TSMimeHdrFieldValueUintInsert.en.rst
> doc/reference/api/TSMimeHdrFieldValueUintSet.en.rst
> doc/reference/api/TSMimeHdrFieldValuesClear.en.rst
> doc/reference/api/TSMimeHdrFieldValuesCount.en.rst
> {code}
> I think this should be coalesced where it makes sense, e.g. the above ought
> to all be in one file, named TSMimeHdrField.en.rst.
> Either that, or we undo the previous coalescing (look at TSDebug.en.rst), and
> split those out into one file per API. I definitely prefer the coalescing for
> sure, since it puts all useful information related to a particular set of
> APIs into one man page.
> I think the commit in a549c31268729823781ee6fe6dff88196eb72589 introduced all
> these files.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
