Details
-
Bug
-
Resolution: Fixed
-
P3: Somewhat important
-
6.2.0
-
None
-
Da Vinci sprint 43
Description
Given the following \page command:
\page this_is_my_page.html
I'd expect the generated html file is indeed this_is_my_page.html. However, QDoc translates the underscores to hyphens and generates this-is-my-page.html instead.
This was surprising to me. At the very least, QDoc should issue a warning that the input to the command is going to be modified in output.
(I understand a possible reason for this is to unify output in multi-author environments such as Qt, another reason may be that Google recommends hyphens over underscores. These are good reasons for the behavior, but do not make up for the element of surprise therein.)
Attachments
For Gerrit Dashboard: QTBUG-97174 | ||||||
---|---|---|---|---|---|---|
# | Subject | Branch | Project | Status | CR | V |
379328,6 | Doc: Add a notice about the nomenclature of files generated by QDoc | dev | qt/qttools | Status: MERGED | +2 | 0 |
379477,2 | Doc: Add a notice about the nomenclature of files generated by QDoc | 6.2 | qt/qttools | Status: MERGED | +2 | 0 |