I did an online search for "Lustre lfsck man page" and it returned the first link https://manpages.org/lfsck/8 which is a super ancient lfsck page from 2005 or so. Another top-listed link is https://man.cx/lustre(7).
It would be useful for the DWG to have someone contact these sites and have them scrape man pages from the primary Lustre Git repo or the Github clone so that they are kept uptodate.
Hi Ellis, yes cleaning up the man page style is fine, especially if it is facilitating upstream acceptance. There will also need some changes to the build and packaging to handle the use of subdirectories, but that is fine.
One note - there are already a few patches updating the man page style, so it would be good to review those and get them landed, and/or base further cleanup patches on top of them.
Andreas Dilger
added a comment - Hi Ellis, yes cleaning up the man page style is fine, especially if it is facilitating upstream acceptance. There will also need some changes to the build and packaging to handle the use of subdirectories, but that is fine.
One note - there are already a few patches updating the man page style, so it would be good to review those and get them landed, and/or base further cleanup patches on top of them.
Andreas – is there interest in my linting and fixing manpages and/or re-organizing into chapters as Alex proposes above? The DWG can definitely take this on, but I want to confirm that this is desirable on the whole before I get too far along scoping and dividing up this work.
Ellis Wilson
added a comment - - edited Andreas – is there interest in my linting and fixing manpages and/or re-organizing into chapters as Alex proposes above? The DWG can definitely take this on, but I want to confirm that this is desirable on the whole before I get too far along scoping and dividing up this work.
manpages.org: this has no about page, and whois info is obfuscated by cloudflare. I don't have a great path forward here.
man.cx: I sent email to Andreas Gohr who appears to run this site (https://www.splitbrain.org/). On the site he says he updates the site straight from manpages in Debian, but I asked for more info on this so we can come up with a strategy to get newer content here.
die.net: I sent email to Aaron, who appears to be the sysadmin for the site (https://github.com/aaron42net). There is no info on how they scrape their manpages, so hopefully he can fill me in.
man7.org: I sent email to Alejandro Colomar, who is the co-maintainer for this. He has already gotten back to me:
Hi Ellis,
On Mon, Jan 13, 2025 at 03:33:07PM +0000, Ellis Wilson wrote:
> Hi Alejandro,
>
> I am assisting with updating Lustre documentation within the Lustre
> community. Lustre is an HPC filesystem used at >50% of the top 500
> supercomputers in the world. It is not presently in-tree in the
> kernel, but was in staging some years ago, and there is on-going work
> to try to get it back in-tree someday. I'm reaching out to see if
> there is any interest in including Lustre manpages on man7.org? If
> there is no interest or I should discuss this with someone else please
> don't hesitate to say so.
man7.org is Michael Kerrisk's server. You should contact him at
<man-pages@man7.org>. I've CCd him in this email.
- Use subdirectories (man1/, man3/, man5/, man7/, man8/) for the
different chapters. That allows reading the link (.so) pages within
the source repository.
- I found some warnings when linting those pages with the build system
of the Linux man-pages project. Here's a fraction of the logs:
alx@devuan:/srv/alx/src/linux/man-pages/man-pages/main$ make MANDIR=/tmp/man/lustre/lustre-release/lustre/doc lint-man -k
MANDOC .tmp/man/lfs-changelog.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-changelog.1:3:88: STYLE: input text line longer than 80 bytes: lfs-changelog, lfs-c...
make: *** [/srv/alx/src/linux/man-pages/man-pages/main/share/mk/lint/man/mandoc.mk:36: .tmp/man/lfs-changelog.1.lint-man.mandoc.touch] Error 1
MANDOC .tmp/man/lfs-find.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-find.1:610:2: ERROR: skipping end of block that is not open: RE
mandoc: .tmp/man/lfs-find.1:794:35: STYLE: unterminated quoted argument
mandoc: .tmp/man/lfs-find.1:1:16: WARNING: cannot parse date, using it verbatim: TH 2024-08-15"
make: *** [/srv/alx/src/linux/man-pages/man-pages/main/share/mk/lint/man/mandoc.mk:36: .tmp/man/lfs-find.1.lint-man.mandoc.touch] Error 1
MANDOC .tmp/man/lfs-getsom.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-getsom.1:23:2: ERROR: skipping unknown macro: .Ex
mandoc: .tmp/man/lfs-getsom.1:30:2: STYLE: fill mode already enabled, skipping: EE
make: *** [/srv/alx/src/linux/man-pages/man-pages/main/share/mk/lint/man/mandoc.mk:36: .tmp/man/lfs-getsom.1.lint-man.mandoc.touch] Error 1
MANDOC .tmp/man/lfs-hsm.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-hsm.1:3:92: STYLE: input text line longer than 80 bytes: hsm_state, hsm_actio...
mandoc: .tmp/man/lfs-hsm.1:27:81: STYLE: input text line longer than 80 bytes: These are a set of l...
make: *** [/srv/alx/src/linux/man-pages/man-pages/main/share/mk/lint/man/mandoc.mk:36: .tmp/man/lfs-hsm.1.lint-man.mandoc.touch] Error 1
MANDOC .tmp/man/lfs-migrate.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-migrate.1:153:84: STYLE: input text line longer than 80 bytes: Do not set LMV_HASH_...
mandoc: .tmp/man/lfs-migrate.1:13:2: WARNING: skipping paragraph macro: br at the end of SH
mandoc: .tmp/man/lfs-migrate.1:21:2: WARNING: skipping paragraph macro: PP after SH
mandoc: .tmp/man/lfs-migrate.1:178:2: WARNING: skipping paragraph macro: PP empty
mandoc: .tmp/man/lfs-migrate.1:202:2: WARNING: skipping paragraph macro: PP empty [...]
You probably want to address most of those. If you have any doubts
using the build system of the Linux man-pages project to lint your
own pages, feel free to ask, CCing the mailing list.
> Thank you for your consideration!
>
> Best,
>
> ellis
Have a lovely day!
Alex
Ellis Wilson
added a comment - manpages.org: this has no about page, and whois info is obfuscated by cloudflare. I don't have a great path forward here.
man.cx: I sent email to Andreas Gohr who appears to run this site ( https://www.splitbrain.org/). On the site he says he updates the site straight from manpages in Debian, but I asked for more info on this so we can come up with a strategy to get newer content here.
die.net: I sent email to Aaron, who appears to be the sysadmin for the site ( https://github.com/aaron42net). There is no info on how they scrape their manpages, so hopefully he can fill me in.
man7.org: I sent email to Alejandro Colomar, who is the co-maintainer for this. He has already gotten back to me:
Hi Ellis,
On Mon, Jan 13, 2025 at 03:33:07PM +0000, Ellis Wilson wrote:
> Hi Alejandro,
>
> I am assisting with updating Lustre documentation within the Lustre
> community. Lustre is an HPC filesystem used at >50% of the top 500
> supercomputers in the world. It is not presently in-tree in the
> kernel, but was in staging some years ago, and there is on-going work
> to try to get it back in-tree someday. I'm reaching out to see if
> there is any interest in including Lustre manpages on man7.org? If
> there is no interest or I should discuss this with someone else please
> don't hesitate to say so.
man7.org is Michael Kerrisk's server. You should contact him at
<man-pages@man7.org>. I've CCd him in this email.
> The manpages for Lustre can be found here if you would like to review
> their count or contents:
> https://github.com/lustre/lustre-release/tree/master/lustre/doc
A few suggestions:
- Use subdirectories (man1/, man3/, man5/, man7/, man8/) for the
different chapters. That allows reading the link (.so) pages within
the source repository.
- I found some warnings when linting those pages with the build system
of the Linux man-pages project. Here's a fraction of the logs:
alx@devuan:/srv/alx/src/linux/man-pages/man-pages/main$ make MANDIR=/tmp/man/lustre/lustre-release/lustre/doc lint-man -k
MANDOC .tmp/man/lfs-changelog.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-changelog.1:3:88: STYLE: input text line longer than 80 bytes: lfs-changelog, lfs-c...
make: *** [/srv/alx/src/linux/man-pages/man-pages/main/share/mk/lint/man/mandoc.mk:36: .tmp/man/lfs-changelog.1.lint-man.mandoc.touch] Error 1
MANDOC .tmp/man/lfs-find.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-find.1:610:2: ERROR: skipping end of block that is not open: RE
mandoc: .tmp/man/lfs-find.1:794:35: STYLE: unterminated quoted argument
mandoc: .tmp/man/lfs-find.1:1:16: WARNING: cannot parse date, using it verbatim: TH 2024-08-15"
make: *** [/srv/alx/src/linux/man-pages/man-pages/main/share/mk/lint/man/mandoc.mk:36: .tmp/man/lfs-find.1.lint-man.mandoc.touch] Error 1
MANDOC .tmp/man/lfs-getsom.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-getsom.1:23:2: ERROR: skipping unknown macro: .Ex
mandoc: .tmp/man/lfs-getsom.1:30:2: STYLE: fill mode already enabled, skipping: EE
make: *** [/srv/alx/src/linux/man-pages/man-pages/main/share/mk/lint/man/mandoc.mk:36: .tmp/man/lfs-getsom.1.lint-man.mandoc.touch] Error 1
MANDOC .tmp/man/lfs-hsm.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-hsm.1:3:92: STYLE: input text line longer than 80 bytes: hsm_state, hsm_actio...
mandoc: .tmp/man/lfs-hsm.1:27:81: STYLE: input text line longer than 80 bytes: These are a set of l...
make: *** [/srv/alx/src/linux/man-pages/man-pages/main/share/mk/lint/man/mandoc.mk:36: .tmp/man/lfs-hsm.1.lint-man.mandoc.touch] Error 1
MANDOC .tmp/man/lfs-migrate.1.lint-man.mandoc.touch
mandoc: .tmp/man/lfs-migrate.1:153:84: STYLE: input text line longer than 80 bytes: Do not set LMV_HASH_...
mandoc: .tmp/man/lfs-migrate.1:13:2: WARNING: skipping paragraph macro: br at the end of SH
mandoc: .tmp/man/lfs-migrate.1:21:2: WARNING: skipping paragraph macro: PP after SH
mandoc: .tmp/man/lfs-migrate.1:178:2: WARNING: skipping paragraph macro: PP empty
mandoc: .tmp/man/lfs-migrate.1:202:2: WARNING: skipping paragraph macro: PP empty
[...]
You probably want to address most of those. If you have any doubts
using the build system of the Linux man-pages project to lint your
own pages, feel free to ask, CCing the mailing list.
> Thank you for your consideration!
>
> Best,
>
> ellis
Have a lovely day!
Alex
People
Ellis Wilson
Andreas Dilger
Votes:
0Vote for this issue
Watchers:
2Start watching this issue
Dates
Created:
Updated:
1 of 13
{"searchers":{"groups":[{"searchers":[{"name":"Project","id":"project","key":"issue.field.project","isShown":true,"lastViewed":1750107480380},{"name":"Summary","id":"summary","key":"issue.field.summary","isShown":true},{"name":"Type","id":"issuetype","key":"issue.field.issuetype","isShown":true,"lastViewed":1750107480382},{"name":"Status","id":"status","key":"issue.field.status","isShown":true,"lastViewed":1750107480395},{"name":"Priority","id":"priority","key":"issue.field.priority","isShown":true},{"name":"Resolution","id":"resolution","key":"issue.field.resolution","isShown":true},{"name":"Creator","id":"creator","key":"issue.field.creator","isShown":true},{"name":"Affects Version","id":"version","key":"issue.field.affectsversions","isShown":true},{"name":"Fix Version","id":"fixfor","key":"issue.field.fixversions","isShown":true},{"name":"Component","id":"component","key":"issue.field.components","isShown":false},{"name":"% Limits","id":"workratio","key":"issue.field.workratio","isShown":true},{"name":"Link types","id":"issue_link_type","key":"issue.field.issuelinks","isShown":true},{"name":"Environment","id":"environment","key":"issue.field.environment","isShown":true},{"name":"Description","id":"description","key":"issue.field.description","isShown":true},{"name":"Comment","id":"comment","key":"issue.field.comment","isShown":true},{"name":"Label","id":"labels","key":"issue.field.labels","isShown":true,"lastViewed":1750107480399},{"name":"Query","id":"text","key":"text","isShown":true},{"name":"Bugzilla ID","id":"customfield_10020","key":"com.atlassian.jira.plugin.system.customfieldtypes:float","isShown":false},{"name":"Business Value","id":"customfield_10003","key":"com.atlassian.jira.plugin.system.customfieldtypes:float","isShown":false},{"name":"Development","id":"customfield_10890","key":"com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary","isShown":true},{"name":"Epic","id":"customfield_10040","key":"com.atlassian.jira.plugin.system.customfieldtypes:labels","isShown":true},{"name":"Epic Colour","id":"customfield_10095","key":"com.pyxis.greenhopper.jira:gh-epic-color","isShown":false},{"name":"Epic Link","id":"customfield_10092","key":"com.pyxis.greenhopper.jira:gh-epic-link","isShown":true},{"name":"Epic Name","id":"customfield_10093","key":"com.pyxis.greenhopper.jira:gh-epic-label","isShown":true},{"name":"Epic Status","id":"customfield_10094","key":"com.pyxis.greenhopper.jira:gh-epic-status","isShown":false},{"name":"Epic/Theme","id":"customfield_10030","key":"com.atlassian.jira.plugin.system.customfieldtypes:labels","isShown":true},{"name":"Flagged","id":"customfield_10000","key":"com.atlassian.jira.plugin.system.customfieldtypes:multicheckboxes","isShown":true},{"name":"IEEL Options","id":"customfield_10191","key":"com.atlassian.jira.plugin.system.customfieldtypes:multiselect","isShown":true},{"name":"Original story points","id":"customfield_11094","key":"com.atlassian.jpo:jpo-custom-field-original-story-points","isShown":true},{"name":"Parent Link","id":"customfield_11091","key":"com.atlassian.jpo:jpo-custom-field-parent","isShown":false},{"name":"Project","id":"customfield_10070","key":"com.atlassian.jira.plugin.system.customfieldtypes:select","isShown":true},{"name":"Rank","id":"customfield_10390","key":"com.pyxis.greenhopper.jira:gh-lexo-rank","isShown":true},{"name":"Rank (Obsolete)","id":"customfield_10001","key":"com.atlassian.jira.plugin.system.customfieldtypes:float","isShown":false},{"name":"Rank (Obsolete)","id":"customfield_10090","key":"com.pyxis.greenhopper.jira:gh-global-rank","isShown":true},{"name":"Release Version History","id":"customfield_10050","key":"com.pyxis.greenhopper.jira:greenhopper-releasedmultiversionhistory","isShown":true},{"name":"Severity","id":"customfield_10060","key":"com.atlassian.jira.plugin.system.customfieldtypes:select","isShown":true},{"name":"Site Affected:","id":"customfield_10190","key":"com.atlassian.jira.plugin.system.customfieldtypes:textfield","isShown":true},{"name":"Sprint","id":"customfield_10091","key":"com.pyxis.greenhopper.jira:gh-sprint","isShown":true},{"name":"Story Points","id":"customfield_10002","key":"com.atlassian.jira.plugin.system.customfieldtypes:float","isShown":true},{"name":"Support Region","id":"customfield_10990","key":"com.atlassian.jira.plugin.system.customfieldtypes:select","isShown":true},{"name":"Team","id":"customfield_11090","key":"com.atlassian.teams:rm-teams-custom-field-team","isShown":true},{"name":"Upstreaming","id":"customfield_10290","key":"com.atlassian.jira.plugin.system.customfieldtypes:select","isShown":true},{"name":"Whiteboard","id":"customfield_10591","key":"com.atlassian.jira.plugin.system.customfieldtypes:textfield","isShown":true},{"name":"issueFunction","id":"customfield_10590","key":"com.onresolve.jira.groovy.groovyrunner:jqlFunctionsCustomFieldType","isShown":true}],"type":"DETAILS","title":"Details"},{"searchers":[{"name":"Created Date","id":"created","key":"issue.field.created","isShown":true},{"name":"Updated Date","id":"updated","key":"issue.field.updated","isShown":true},{"name":"Resolution Date","id":"resolutiondate","key":"issue.field.resolution.date","isShown":true},{"name":"Due Date","id":"duedate","key":"issue.field.duedate","isShown":true},{"name":"Baseline end date","id":"customfield_10494","key":"com.atlassian.jira.plugin.system.customfieldtypes:datepicker","isShown":true},{"name":"Baseline start date","id":"customfield_10492","key":"com.atlassian.jira.plugin.system.customfieldtypes:datepicker","isShown":true},{"name":"Baseline start date","id":"customfield_10790","key":"com.atlassian.jira.plugin.system.customfieldtypes:datepicker","isShown":true},{"name":"End date","id":"customfield_10490","key":"com.atlassian.jira.plugin.system.customfieldtypes:datepicker","isShown":true},{"name":"Start date","id":"customfield_10493","key":"com.atlassian.jira.plugin.system.customfieldtypes:datepicker","isShown":true},{"name":"Target end","id":"customfield_11093","key":"com.atlassian.jpo:jpo-custom-field-baseline-end","isShown":true},{"name":"Target start","id":"customfield_11092","key":"com.atlassian.jpo:jpo-custom-field-baseline-start","isShown":true}],"type":"DATES","title":"Dates"},{"searchers":[{"name":"Assignee","id":"assignee","key":"issue.field.assignee","isShown":true,"lastViewed":1750107480397},{"name":"Reporter","id":"reporter","key":"issue.field.reporter","isShown":true}],"type":"PEOPLE","title":"People"}]},"values":{"issuetype":{"name":"Type","editHtml":"\n\n\n\n <div class=\"field-group aui-field-issuetype\" >\n <label for=\"searcher-type\">Type</label> <select class=\"select js-default-checkboxmultiselect\"\n id=\"searcher-type\"\n multiple=\"multiple\"\n name=\"type\"\n data-max-inline-results-displayed=\"100\"\n data-placeholder-text=\"Find Issue Types...\">\n <optgroup>\n \n <option class=\" \"\n id=\"type_-2\"\n title=\"All Standard Issue Types\"\n value=\"-2\">All Standard Issue Types</option>\n \n <option class=\" \"\n id=\"type_-3\"\n title=\"All Sub-Task Issue Types\"\n value=\"-3\">All Sub-Task Issue Types</option>\n </optgroup>\n\n <optgroup label=\"Standard Issue Types\">\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/secure/viewavatar?size=xsmall&avatarId=11303&avatarType=issuetype\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_1\"\n title=\"Bug\"\n value=\"1\">Bug</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/images/icons/issuetypes/epic.png\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_5\"\n title=\"Epic\"\n value=\"5\">Epic</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/secure/viewavatar?size=xsmall&avatarId=11310&avatarType=issuetype\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_4\"\n title=\"Improvement\"\n value=\"4\">Improvement</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/secure/viewavatar?size=xsmall&avatarId=11311&avatarType=issuetype\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_2\"\n title=\"New Feature\"\n value=\"2\">New Feature</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/images/icons/issuetypes/undefined.png\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_9\"\n title=\"Question/Request\"\n value=\"9\">Question/Request</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/secure/viewavatar?size=xsmall&avatarId=11300&avatarType=issuetype\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_10200\"\n title=\"Requirement\"\n value=\"10200\">Requirement</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/secure/viewavatar?size=xsmall&avatarId=11315&avatarType=issuetype\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_6\"\n title=\"Story\"\n value=\"6\">Story</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/secure/viewavatar?size=xsmall&avatarId=11318&avatarType=issuetype\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_3\"\n title=\"Task\"\n value=\"3\">Task</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/download/resources/com.thed.zephyr.je/images/icons/ico_zephyr_issuetype.png\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_10100\"\n title=\"Test\"\n value=\"10100\">Test</option>\n </optgroup>\n\n <optgroup label=\"Sub-Task Issue Types\">\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/secure/viewavatar?size=xsmall&avatarId=11316&avatarType=issuetype\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_10300\"\n title=\"Requirement task\"\n value=\"10300\">Requirement task</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/secure/viewavatar?size=xsmall&avatarId=11300&avatarType=issuetype\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_8\"\n title=\"Review task\"\n value=\"8\">Review task</option>\n \n <option class=\" imagebacked 10000 \"\n data-icon=\"/images/icons/issuetypes/task_agile.png\"\n data-fallback-icon=\"/images/icons/issuetypes/blank.png\"\n id=\"type_7\"\n title=\"Technical task\"\n value=\"7\">Technical task</option>\n </optgroup>\n </select>\n </div>\n ","validSearcher":true,"isShown":true},"project":{"name":"Project","editHtml":" \n <div class=\"field-group aui-field-project\" >\n <label for=\"searcher-pid\">Project</label> <select class=\"js-project-checkboxmultiselect\"\n data-placeholder-text=\"Find Projects...\"\n id=\"searcher-pid\"\n multiple=\"multiple\"\n name=\"pid\">\n <optgroup label=\"Recent Projects\">\n </optgroup>\n <optgroup label=\"All Projects\" >\n \n <option data-icon=\"/secure/projectavatar?pid=11910&size=small\"\n title=\"Lemur\"\n value=\"11910\">\n Lemur (LMR)\n </option>\n <option data-icon=\"/secure/projectavatar?pid=10000&size=small\"\n title=\"Lustre\"\n value=\"10000\">\n Lustre (LU)\n </option>\n <option data-icon=\"/secure/projectavatar?pid=10070&size=small\"\n title=\"Lustre Documentation\"\n value=\"10070\">\n Lustre Documentation (LUDOC)\n </option>\n </optgroup>\n </select>\n </div>\n \n\n","validSearcher":true,"isShown":true},"assignee":{"name":"Assignee","editHtml":"\n \n <div class=\"field-group aui-field-userlist\" >\n <label for=\"searcher-assigneeSelect\">Assignee</label> <fieldset rel=\"assignee\" class=\"hidden user-group-searcher-params\">\n </fieldset>\n <select class=\"js-usergroup-checkboxmultiselect\" multiple=\"multiple\" id=\"assignee\" name=\"assignee\" data-placeholder-text=\"Enter username or group\">\n <optgroup>\n <option class=\"headerOption\" data-icon=\"https://jira.whamcloud.com/secure/useravatar?size=xsmall&avatarId=10123\" value=\"empty\" title=\"Unassigned\">Unassigned</option>\n </optgroup>\n <optgroup>\n </optgroup>\n </select>\n <input type=\"hidden\" name=\"check_prev_assignee\" value=\"true\">\n </div>\n \n","validSearcher":true,"isShown":true},"status":{"name":"Status","editHtml":"\n <div class=\"field-group aui-field-constants\" >\n <label for=\"searcher-status\">Status</label> <select class=\"select js-default-checkboxmultiselectstatuslozenge\"\n data-placeholder-text=\"Find Statuses...\"\n id=\"searcher-status\"\n multiple=\"multiple\"\n name=\"status\"\n data-max-inline-results-displayed=\"100\"\n data-footer-text=\"-78 more options. Continue typing to refine further.\" data-status-lozenge=\"true\">\n <optgroup >\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/open.png\" value=\"1\" title=\"Open\" data-simple-status=\"{"id":"1","name":"Open","description":"The issue is open and ready for the assignee to start work on it.","iconUrl":"/images/icons/statuses/open.png","statusCategory":{"id":2,"key":"new","colorName":"default"}}\">Open</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/inprogress.png\" value=\"3\" title=\"In Progress\" data-simple-status=\"{"id":"3","name":"In Progress","description":"This issue is being actively worked on at the moment by the assignee.","iconUrl":"/images/icons/statuses/inprogress.png","statusCategory":{"id":4,"key":"indeterminate","colorName":"inprogress"}}\">In Progress</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/reopened.png\" value=\"4\" title=\"Reopened\" data-simple-status=\"{"id":"4","name":"Reopened","description":"This issue was once resolved, but the resolution was deemed incorrect. From here issues are either marked assigned or resolved.","iconUrl":"/images/icons/statuses/reopened.png","statusCategory":{"id":2,"key":"new","colorName":"default"}}\">Reopened</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/resolved.png\" value=\"5\" title=\"Resolved\" data-simple-status=\"{"id":"5","name":"Resolved","description":"A resolution has been taken, and it is awaiting verification by reporter. From here issues are either reopened, or are closed.","iconUrl":"/images/icons/statuses/resolved.png","statusCategory":{"id":3,"key":"done","colorName":"success"}}\">Resolved</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/closed.png\" value=\"6\" title=\"Closed\" data-simple-status=\"{"id":"6","name":"Closed","description":"The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.","iconUrl":"/images/icons/statuses/closed.png","statusCategory":{"id":3,"key":"done","colorName":"success"}}\">Closed</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10000\" title=\"Accepted\" data-simple-status=\"{"id":"10000","name":"Accepted","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":3,"key":"done","colorName":"success"}}\">Accepted</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10001\" title=\"In Backlog\" data-simple-status=\"{"id":"10001","name":"In Backlog","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":4,"key":"indeterminate","colorName":"inprogress"}}\">In Backlog</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10002\" title=\"Blocked External\" data-simple-status=\"{"id":"10002","name":"Blocked External","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":2,"key":"new","colorName":"default"}}\">Blocked External</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10003\" title=\"Blocked Internal\" data-simple-status=\"{"id":"10003","name":"Blocked Internal","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":4,"key":"indeterminate","colorName":"inprogress"}}\">Blocked Internal</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10004\" title=\"Pending Review\" data-simple-status=\"{"id":"10004","name":"Pending Review","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":4,"key":"indeterminate","colorName":"inprogress"}}\">Pending Review</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10105\" title=\"Waiting On Gatekeeper\" data-simple-status=\"{"id":"10105","name":"Waiting On Gatekeeper","description":"Ticket is waiting on the gate keeper for code to land.","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":4,"key":"indeterminate","colorName":"inprogress"}}\">Waiting On Gatekeeper</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/closed.png\" value=\"10205\" title=\"Done\" data-simple-status=\"{"id":"10205","name":"Done","description":"","iconUrl":"/images/icons/statuses/closed.png","statusCategory":{"id":3,"key":"done","colorName":"success"}}\">Done</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/open.png\" value=\"10206\" title=\"To Do\" data-simple-status=\"{"id":"10206","name":"To Do","description":"","iconUrl":"/images/icons/statuses/open.png","statusCategory":{"id":2,"key":"new","colorName":"default"}}\">To Do</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/information.png\" value=\"10305\" title=\"In Review\" data-simple-status=\"{"id":"10305","name":"In Review","description":"","iconUrl":"/images/icons/statuses/information.png","statusCategory":{"id":4,"key":"indeterminate","colorName":"inprogress"}}\">In Review</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10505\" title=\"Waiting\" data-simple-status=\"{"id":"10505","name":"Waiting","description":"Waiting for a response or something else that is required to complete the issue.","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":4,"key":"indeterminate","colorName":"inprogress"}}\">Waiting</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10605\" title=\"Committed\" data-simple-status=\"{"id":"10605","name":"Committed","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":2,"key":"new","colorName":"default"}}\">Committed</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10606\" title=\"Rejected\" data-simple-status=\"{"id":"10606","name":"Rejected","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":3,"key":"done","colorName":"success"}}\">Rejected</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10607\" title=\"Completed\" data-simple-status=\"{"id":"10607","name":"Completed","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":3,"key":"done","colorName":"success"}}\">Completed</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10608\" title=\"New\" data-simple-status=\"{"id":"10608","name":"New","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":2,"key":"new","colorName":"default"}}\">New</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10705\" title=\"Awaiting Verification\" data-simple-status=\"{"id":"10705","name":"Awaiting Verification","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":4,"key":"indeterminate","colorName":"inprogress"}}\">Awaiting Verification</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10706\" title=\"Fix Verified\" data-simple-status=\"{"id":"10706","name":"Fix Verified","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":3,"key":"done","colorName":"success"}}\">Fix Verified</option>\n <option class=\"imagebacked\" data-icon=\"/images/icons/statuses/generic.png\" value=\"10806\" title=\"Need Information\" data-simple-status=\"{"id":"10806","name":"Need Information","description":"","iconUrl":"/images/icons/statuses/generic.png","statusCategory":{"id":2,"key":"new","colorName":"default"}}\">Need Information</option>\n </optgroup>\n</select>\n </div>\n \n","validSearcher":true,"isShown":true},"labels":{"name":"Label","viewHtml":" <div class=\"searcherValue\">\n \n <label class=\"fieldLabel\" for=\"fieldlabels\">Label:</label><span id=\"fieldlabels\" class=\"fieldValue\">\n \n dwg\n</span></div>\n","editHtml":"\n <div class=\"field-group aui-field-labels\" >\n <label for=\"searcher-labels\">Labels</label> <select class=\"js-label-checkboxmultiselect\" multiple=\"multiple\" id=\"searcher-labels\" name=\"labels\" data-placeholder-text=\"Find Labels...\">\n <option value=\"dwg\" title=\"dwg\" selected=\"selected\">dwg</option>\n </select>\n </div>\n \n","jql":"labels = dwg","validSearcher":true,"isShown":true}}}
[{"id":-1,"name":"My open issues","jql":"assignee = currentUser() AND resolution = Unresolved order by updated DESC","isSystem":true,"sharePermissions":[],"requiresLogin":true},{"id":-2,"name":"Reported by me","jql":"reporter = currentUser() order by created DESC","isSystem":true,"sharePermissions":[],"requiresLogin":true},{"id":-4,"name":"All issues","jql":"order by created DESC","isSystem":true,"sharePermissions":[],"requiresLogin":false},{"id":-5,"name":"Open issues","jql":"resolution = Unresolved order by priority DESC,updated DESC","isSystem":true,"sharePermissions":[],"requiresLogin":false},{"id":-9,"name":"Done issues","jql":"statusCategory = Done order by updated DESC","isSystem":true,"sharePermissions":[],"requiresLogin":false},{"id":-3,"name":"Viewed recently","jql":"issuekey in issueHistory() order by lastViewed DESC","isSystem":true,"sharePermissions":[],"requiresLogin":false},{"id":-6,"name":"Created recently","jql":"created >= -1w order by created DESC","isSystem":true,"sharePermissions":[],"requiresLogin":false},{"id":-7,"name":"Resolved recently","jql":"resolutiondate >= -1w order by updated DESC","isSystem":true,"sharePermissions":[],"requiresLogin":false},{"id":-8,"name":"Updated recently","jql":"updated >= -1w order by updated DESC","isSystem":true,"sharePermissions":[],"requiresLogin":false}]
Major
Hi Ellis, yes cleaning up the man page style is fine, especially if it is facilitating upstream acceptance. There will also need some changes to the build and packaging to handle the use of subdirectories, but that is fine.
One note - there are already a few patches updating the man page style, so it would be good to review those and get them landed, and/or base further cleanup patches on top of them.