archmanweb issueshttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues2020-09-03T18:46:28Zhttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/1Improve page layout and CSS stylesheets2020-09-03T18:46:28ZSven-Hendrik Haasesvenstaro@archlinux.orgImprove page layout and CSS stylesheets*Created by: lahwaacz*
The website needs to improve the layout of its pages and provide some CSS stylesheets. I can't do it myself, so here is a quickstart guide for the contributors. One day it will appear in the README, when it exists...*Created by: lahwaacz*
The website needs to improve the layout of its pages and provide some CSS stylesheets. I can't do it myself, so here is a quickstart guide for the contributors. One day it will appear in the README, when it exists...
1. Install the dependencies: [python-django](https://www.archlinux.org/packages/extra/any/python-django/), [python-requests](https://www.archlinux.org/packages/extra/any/python-requests/), [pyalpm](https://www.archlinux.org/packages/extra/x86_64/pyalpm/), [mandoc](https://aur.archlinux.org/packages/mandoc/) (if you want to install it side-by-side with the man-db and groff packages, I use [this modified PKGBUILD](https://gist.github.com/lahwaacz/abfd8793ed96abf3219d066a5049654a)).
2. Fork this repository, clone the fork and change into its directory.
3. Copy `mysite/local_settings.py.example` to `mysite/local_settings.py` and edit `DEBUG = True` and the `SECRET_KEY` variable.
4. Configure a connection to a [PostgreSQL](https://wiki.archlinux.org/index.php/PostgreSQL) server in the [Django database settings](https://docs.djangoproject.com/en/1.11/ref/settings/#databases) in the `mysite/local_settings.py` file.
5. Initialize the Django database by running `./manage.py makemigrations` and `./manage.py migrate`.
6. Start the development web server with `./manage.py runserver`. The site should be available at http://localhost:8000, saying that there are 0 man pages and 0 packages (because they were not imported yet). The server will automatically reload when you make changes to the webapp code or templates.
7. Run the `update.py` script to import some man pages. __However__, note that the full import requires to download about 7.5 GB of packages from a mirror of the Arch repos and then the extraction takes about 20-30 minutes. (The volume of all man pages is less than 300 MB though.) If you won't need all man pages for the development, you can run e.g. `update.py --only-repos core` to import only man pages from the core repository (the smallest one, download size is about 160 MB) or even `update.py --only-packages coreutils man-pages`.
That's it! Your testing website should now be (almost) fully functional, depending on how many packages you imported. Navigate to the URL of some man page and verify that it's HTML version is actually served.
Before you start working on the design, note that:
- the CSS stylesheets are `archweb_manpages/static/archweb_manpages/*.css`
- the templates for the HTML pages are stored in `archweb_manpages/templates/`. See [The Django template language](https://docs.djangoproject.com/en/1.11/ref/templates/language/) for details.
Of course if something doesn't work or you need more help, just let me know!https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/2crash on zshall(1)2021-01-11T21:03:22ZSven-Hendrik Haasesvenstaro@archlinux.orgcrash on zshall(1)*Created by: nl6720*
http://jlk.fjfi.cvut.cz/arch/manpages/man/extra/zsh/zshall.1.en
```
500 — Internal server error
The web application crashed.
```*Created by: nl6720*
http://jlk.fjfi.cvut.cz/arch/manpages/man/extra/zsh/zshall.1.en
```
500 — Internal server error
The web application crashed.
```https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/3Missing README2020-07-25T09:08:37ZJelle van der WaaMissing READMEThe project lacks a readme and installation instructions, which makes it hard to try it out locally.
The project lacks a readme and installation instructions, which makes it hard to try it out locally.
https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/5crash on mc(1)2017-12-02T18:12:26ZSven-Hendrik Haasesvenstaro@archlinux.orgcrash on mc(1)*Created by: nl6720*
http://jlk.fjfi.cvut.cz/arch/manpages/man/mc.1
```
500 — Internal server error
The web application crashed.
```*Created by: nl6720*
http://jlk.fjfi.cvut.cz/arch/manpages/man/mc.1
```
500 — Internal server error
The web application crashed.
```https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/6Internal server errors2018-08-12T12:39:48ZSven-Hendrik Haasesvenstaro@archlinux.orgInternal server errors*Created by: Larivact*
Search queries yielding a "500 — Internal server error":
```
x
te
test123
tra
open
kfind
```*Created by: Larivact*
Search queries yielding a "500 — Internal server error":
```
x
te
test123
tra
open
kfind
```https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/7netctl.profile(5): missing sections in TOC2018-08-30T07:37:35ZSven-Hendrik Haasesvenstaro@archlinux.orgnetctl.profile(5): missing sections in TOC*Created by: nl6720*
[`netctl.profile(5)`](https://jlk.fjfi.cvut.cz/arch/manpages/man/netctl.profile.5) doesn't show the `OPTIONS FOR ... CONNECTIONS` sections in the table of contents.
The issue seems to be the fancy quoting used in t...*Created by: nl6720*
[`netctl.profile(5)`](https://jlk.fjfi.cvut.cz/arch/manpages/man/netctl.profile.5) doesn't show the `OPTIONS FOR ... CONNECTIONS` sections in the table of contents.
The issue seems to be the fancy quoting used in the man page.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/8Links of cross-references are broken2018-08-30T07:41:05ZSven-Hendrik Haasesvenstaro@archlinux.orgLinks of cross-references are broken*Created by: wlhlm*
Cross-reference HTML links are broken since they are missing a `/`.
An [example manpage](https://jlk.fjfi.cvut.cz/arch/manpages/man/pam_env.8) references `pam(8)` in the `SEE ALSO`-section, but the link is
```
...*Created by: wlhlm*
Cross-reference HTML links are broken since they are missing a `/`.
An [example manpage](https://jlk.fjfi.cvut.cz/arch/manpages/man/pam_env.8) references `pam(8)` in the `SEE ALSO`-section, but the link is
```
https://jlk.fjfi.cvut.cz/arch/manpagesman/pam.8.en
```
rather than
```
https://jlk.fjfi.cvut.cz/arch/manpages/man/pam.8.en
```
This is probably fixed by adding the `/` on the following line (sorry for being too lazy to open a pull request):
https://github.com/lahwaacz/archweb_manpages/blob/9d688820b0a7d78291c769fb71e91d3ffd57a834/archweb_manpages/utils.py#L81-L83https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/9Asynchronize manual page generation2019-12-06T23:24:50ZSven-Hendrik Haasesvenstaro@archlinux.orgAsynchronize manual page generation*Created by: FranklinYu*
When I first visit [less(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/less.1) today it wasn't responsive. Minutes later when I visit it again it becomes steadily available. I assume that it is only generated a...*Created by: FranklinYu*
When I first visit [less(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/less.1) today it wasn't responsive. Minutes later when I visit it again it becomes steadily available. I assume that it is only generated as needed. It would be cool if there is at least some response so that I won't be wondering whether the server is down.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/11Missing license?2020-07-19T08:20:50ZSven-Hendrik Haasesvenstaro@archlinux.orgMissing license?*Created by: chris34*
I couldn't find any LICENSE file in the repository. Is it currently missing or did i just oversee it?*Created by: chris34*
I couldn't find any LICENSE file in the repository. Is it currently missing or did i just oversee it?https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/12`./manage.py migrate` fails with traceback2020-07-19T20:12:21ZSven-Hendrik Haasesvenstaro@archlinux.org`./manage.py migrate` fails with traceback*Created by: chris34*
I wanted to setup a local instance. However, migrate fails with the following traceback:
```
$ ./manage.py migrate
Operations to perform:
Apply all migrations: archweb_manpages
Running migrations:
Apply...*Created by: chris34*
I wanted to setup a local instance. However, migrate fails with the following traceback:
```
$ ./manage.py migrate
Operations to perform:
Apply all migrations: archweb_manpages
Running migrations:
Applying archweb_manpages.0001_initial...Traceback (most recent call last):
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 84, in _execute
return self.cursor.execute(sql)
psycopg2.errors.UndefinedObject: FEHLER: Datentyp text hat keine Standardoperatorklasse für Zugriffsmethode »gin«
HINT: Sie müssen für den Index eine Operatorklasse angeben oder eine Standardoperatorklasse für den Datentyp definieren.
The above exception was the direct cause of the following exception:
Traceback (most recent call last):
File "./manage.py", line 22, in <module>
execute_from_command_line(sys.argv)
File "/usr/lib/python3.8/site-packages/django/core/management/__init__.py", line 401, in execute_from_command_line
utility.execute()
File "/usr/lib/python3.8/site-packages/django/core/management/__init__.py", line 395, in execute
self.fetch_command(subcommand).run_from_argv(self.argv)
File "/usr/lib/python3.8/site-packages/django/core/management/base.py", line 328, in run_from_argv
self.execute(*args, **cmd_options)
File "/usr/lib/python3.8/site-packages/django/core/management/base.py", line 369, in execute
output = self.handle(*args, **options)
File "/usr/lib/python3.8/site-packages/django/core/management/base.py", line 83, in wrapped
res = handle_func(*args, **kwargs)
File "/usr/lib/python3.8/site-packages/django/core/management/commands/migrate.py", line 231, in handle
post_migrate_state = executor.migrate(
File "/usr/lib/python3.8/site-packages/django/db/migrations/executor.py", line 117, in migrate
state = self._migrate_all_forwards(state, plan, full_plan, fake=fake, fake_initial=fake_initial)
File "/usr/lib/python3.8/site-packages/django/db/migrations/executor.py", line 147, in _migrate_all_forwards
state = self.apply_migration(state, migration, fake=fake, fake_initial=fake_initial)
File "/usr/lib/python3.8/site-packages/django/db/migrations/executor.py", line 245, in apply_migration
state = migration.apply(state, schema_editor)
File "/usr/lib/python3.8/site-packages/django/db/migrations/migration.py", line 124, in apply
operation.database_forwards(self.app_label, schema_editor, old_state, project_state)
File "/usr/lib/python3.8/site-packages/django/db/migrations/operations/models.py", line 739, in database_forwards
schema_editor.add_index(model, self.index)
File "/usr/lib/python3.8/site-packages/django/db/backends/postgresql/schema.py", line 174, in add_index
self.execute(index.create_sql(model, self, concurrently=concurrently), params=None)
File "/usr/lib/python3.8/site-packages/django/db/backends/base/schema.py", line 142, in execute
cursor.execute(sql, params)
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 100, in execute
return super().execute(sql, params)
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 68, in execute
return self._execute_with_wrappers(sql, params, many=False, executor=self._execute)
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 77, in _execute_with_wrappers
return executor(sql, params, many, context)
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 86, in _execute
return self.cursor.execute(sql, params)
File "/usr/lib/python3.8/site-packages/django/db/utils.py", line 90, in __exit__
raise dj_exc_value.with_traceback(traceback) from exc_value
File "/usr/lib/python3.8/site-packages/django/db/backends/utils.py", line 84, in _execute
return self.cursor.execute(sql)
django.db.utils.ProgrammingError: FEHLER: Datentyp text hat keine Standardoperatorklasse für Zugriffsmethode »gin«
HINT: Sie müssen für den Index eine Operatorklasse angeben oder eine Standardoperatorklasse für den Datentyp definieren.
```
Sorry, for the traceback being in German. I could not get the language changed, even if i changed the locale. As i searched for a solution myself, i found probably the error message in English, but not a solution…
```
ERROR: data type text has no default operator class for access method "gin"
HINT: You must specify an operator class for the index or define a default operator class for the data type.
```
Versions currently installed:
```
$ pacman -Qi python-psycopg2 postgresql python python-django | egrep 'Name|Version'
Name : python-psycopg2
Version : 2.8.5-1
Name : postgresql
Version : 12.3-2
Name : python
Version : 3.8.3-1
Name : python-django
Version : 3.0.8-2
```
Hope that helps to debug the problem.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/15Responsive layout for the man page view2020-09-03T18:46:29ZSven-Hendrik Haasesvenstaro@archlinux.orgResponsive layout for the man page view*Created by: lahwaacz*
When the screen is too narrow to display the man page and sidebar side by side, the "sidebar" should be displayed on top of the manual (maybe collapsed by default). This should be easy with a [responsive design](h...*Created by: lahwaacz*
When the screen is too narrow to display the man page and sidebar side by side, the "sidebar" should be displayed on top of the manual (maybe collapsed by default). This should be easy with a [responsive design](https://www.w3schools.com/html/html_responsive.asp).https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/16Full-text (or "apropos-like") search2024-03-02T12:42:32ZSven-Hendrik Haasesvenstaro@archlinux.orgFull-text (or "apropos-like") search*Created by: lahwaacz*
PostgreSQL has quite effective indexes for full-text search. They are also available in Django: https://docs.djangoproject.com/en/3.1/ref/contrib/postgres/search/
But indexing full man pages would be probably sti...*Created by: lahwaacz*
PostgreSQL has quite effective indexes for full-text search. They are also available in Django: https://docs.djangoproject.com/en/3.1/ref/contrib/postgres/search/
But indexing full man pages would be probably still very slow. Instead we can extract a short description from each man page (the content of the `NAME` section - that's what [makewhatis(8)](https://mandoc.bsd.lv/man/makewhatis.8.html) does) for faster indexing.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/20Add form for the listing view2021-03-26T09:29:23ZSven-Hendrik Haasesvenstaro@archlinux.orgAdd form for the listing view*Created by: lahwaacz*
Since the search page has a nice form to set search parameters, we should add the same thing to the listing view to set filter parameters and ordering.
When done, the information about listings in `index.html` sh...*Created by: lahwaacz*
Since the search page has a nice form to set search parameters, we should add the same thing to the listing view to set filter parameters and ordering.
When done, the information about listings in `index.html` should be updated.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/24Center page2021-01-21T07:42:52ZSven-Hendrik Haasesvenstaro@archlinux.orgCenter page*Created by: FFY00*
Currently the content is placed at the left, this does not scale well with big screens. Would it be possible to center the content like most websites do?
Screenshot on my 4k screen for eg.
![arch-man-content-left](h...*Created by: FFY00*
Currently the content is placed at the left, this does not scale well with big screens. Would it be possible to center the content like most websites do?
Screenshot on my 4k screen for eg.
![arch-man-content-left](https://user-images.githubusercontent.com/11718923/101925923-5e82e000-3bca-11eb-9363-298ea147e6c4.png)Filipe Laínslains@archlinux.orgJakub KlinkovskýFilipe Laínslains@archlinux.orghttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/25Fix links in README2021-01-21T07:42:53ZSven-Hendrik Haasesvenstaro@archlinux.orgFix links in READMEMany of the links in the README do not point to the live instance at man.archlinux.org. This should be fixed.Many of the links in the README do not point to the live instance at man.archlinux.org. This should be fixed.Jakub KlinkovskýJakub Klinkovskýhttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/26Add a link to manpages on primary site2021-01-11T20:57:33ZSven-Hendrik Haasesvenstaro@archlinux.orgAdd a link to manpages on primary siteI think it'd be nice if this application was discoverable from the main site somewhere as an important part of documentation. Perhaps get together with @jelle and see where a good place for a link would be?I think it'd be nice if this application was discoverable from the main site somewhere as an important part of documentation. Perhaps get together with @jelle and see where a good place for a link would be?https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/28Add secure headers2021-06-05T06:33:12ZJelle van der WaaAdd secure headersSee the [securityheaders.com report](https://securityheaders.com/?q=https%3A%2F%2Fman.archlinux.org&followRedirects=on), some security headers are missing.
* [X_FRAME_OPTIONS](https://docs.djangoproject.com/en/3.1/ref/clickjacking/)
* [...See the [securityheaders.com report](https://securityheaders.com/?q=https%3A%2F%2Fman.archlinux.org&followRedirects=on), some security headers are missing.
* [X_FRAME_OPTIONS](https://docs.djangoproject.com/en/3.1/ref/clickjacking/)
* [Referrer policy](https://docs.djangoproject.com/en/3.1/ref/middleware/#referrer-policy)
* [X-Content-Type-Options](https://docs.djangoproject.com/en/3.1/ref/settings/#secure-content-type-nosniff)
django-csp needs to be packaged in our repos to be enabled and configured for Content-Security-Policy.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/30.Bd -literal -compact in mmcli(1) is not formated2022-08-19T19:58:14Znl6720.Bd -literal -compact in mmcli(1) is not formatedhttps://man.archlinux.org/man/mmcli.1#EXAMPLEShttps://man.archlinux.org/man/mmcli.1#EXAMPLESJakub KlinkovskýJakub Klinkovskýhttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/31HTML "a href=" heading links not URL escaped2021-08-30T17:34:44ZJelle van der WaaHTML "a href=" heading links not URL escapedApologies if this is the wrong place to post this but it appears I can't add issues to https://gitlab.archlinux.org/archlinux/archmanweb
Description:
The HTML "a href" links generated for headings don't appear to be URL escaped, so you...Apologies if this is the wrong place to post this but it appears I can't add issues to https://gitlab.archlinux.org/archlinux/archmanweb
Description:
The HTML "a href" links generated for headings don't appear to be URL escaped, so you can't copy and paste them into other places (like the Arch Wiki) if the heading has special characters in it.
Steps to reproduce:
1. Go to https://man.archlinux.org/man/systemd.network.5
2. Scroll down to the fourth heading "[MATCH] SECTION OPTIONS" (or any other heading with square brackets in it)
3. Right-click on the heading and copy the URL.
4. Observe it is not a valid URL as the anchor contains square brackets rather than %5D type escape codes. For example you can't paste it into the Arch Linux wiki as MediaWiki does not recognise the square brackets as part of the URL.
The heading just needs to be URL-encoded before having the '#' added to the front of it.
Originally reported https://bugs.archlinux.org/task/69465https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/32Add robots.txt2021-07-28T18:35:21ZJelle van der WaaAdd robots.txtCurrently the website has no robots.txt and I think we want to exclude /search from being indexed. (Archweb does something similiar)Currently the website has no robots.txt and I think we want to exclude /search from being indexed. (Archweb does something similiar)Jakub KlinkovskýJakub Klinkovskýhttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/33favicon.ico missing?2021-05-18T19:55:36ZJelle van der Waafavicon.ico missing?On `man.archlinux.org` the nginx error log is full with:
```
2021/05/18 18:13:37 [error] 30411#30411: *149634 open() "/srv/http/archmanweb/repo/collected_static/favicon.ico" failed (2: No such file or directory), client: 60.13.138.32, s...On `man.archlinux.org` the nginx error log is full with:
```
2021/05/18 18:13:37 [error] 30411#30411: *149634 open() "/srv/http/archmanweb/repo/collected_static/favicon.ico" failed (2: No such file or directory), client: 60.13.138.32, server: man.archlinux.org, request: "GET /favicon.ico HTTP/1.1", host: "man.archlinux.org"
```https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/34CSS instructions mising2021-06-05T06:57:53ZJelle van der WaaCSS instructions misingThe readme lacks the recommendation to either do a `git submodule sync` or --recursive git clone to fetch the css submodule.
After that the `static/archlinux-common/navbar.css` file still does not exists.The readme lacks the recommendation to either do a `git submodule sync` or --recursive git clone to fetch the css submodule.
After that the `static/archlinux-common/navbar.css` file still does not exists.Jakub KlinkovskýJakub Klinkovskýhttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/35man pages from section 3P do not get linked2022-08-19T19:56:56Znl6720man pages from section 3P do not get linkedman pages whose section is specified as `3P` (capital `P`) in `\fB...\fP` do not get linked.
For example, `gethostname(3P)` in https://man.archlinux.org/man/agetty.8.man pages whose section is specified as `3P` (capital `P`) in `\fB...\fP` do not get linked.
For example, `gethostname(3P)` in https://man.archlinux.org/man/agetty.8.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/36Incorrect indentation in mpc manpage2022-11-03T14:47:05ZPatrick SmitsIncorrect indentation in mpc manpageIn the 'mpc' man page (https://man.archlinux.org/man/mpc.1), in the 'COMMANDS' section, the commands are not equally indented.In the 'mpc' man page (https://man.archlinux.org/man/mpc.1), in the 'COMMANDS' section, the commands are not equally indented.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/37Suggested package links look like man-page links and fail2022-08-22T11:51:46Zjakob kSuggested package links look like man-page links and fail- Search for "mitmproxy"
- No man-page results
- "Results in package names and descriptions" lists the package.
- The link (in the page source) is `<a href="/listing/community/mitmproxy/">community/mitmproxy</a>`
- Note the missing hos...- Search for "mitmproxy"
- No man-page results
- "Results in package names and descriptions" lists the package.
- The link (in the page source) is `<a href="/listing/community/mitmproxy/">community/mitmproxy</a>`
- Note the missing host part of the URL and the format for man-page links
- So the link points to https://man.archlinux.org/listing/community/mitmproxy/ instead of the correct https://archlinux.org/packages/community/any/mitmproxy/ and fails to resolve.Jakub KlinkovskýJakub Klinkovskýhttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/39btrfs man pages are missing links to other man pages2022-11-05T01:07:07Znl6720btrfs man pages are missing links to other man pageshttps://man.archlinux.org/man/btrfs.8 lists multiple other man pages, but they are not linked.
From what I can tell, the man pages are generated from https://github.com/kdave/btrfs-progs/tree/master/Documentation using `sphinx-build`.https://man.archlinux.org/man/btrfs.8 lists multiple other man pages, but they are not linked.
From what I can tell, the man pages are generated from https://github.com/kdave/btrfs-progs/tree/master/Documentation using `sphinx-build`.Jakub KlinkovskýJakub Klinkovskýhttps://gitlab.archlinux.org/archlinux/archmanweb/-/issues/40HTTP 500 when selecting section 12023-01-13T02:32:28ZDaniel ParksHTTP 500 when selecting section 1When I try to look up a command under section 1, for example, https://man.archlinux.org/search?q=man&section=1 , archmanweb responds with error 500.When I try to look up a command under section 1, for example, https://man.archlinux.org/search?q=man§ion=1 , archmanweb responds with error 500.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/41Extra newlines in codeblocks2024-03-02T12:16:57ZHarold ChengExtra newlines in codeblockse.g. in [fcntl.2](https://man.archlinux.org/man/fcntl.2.en#Advisory_record_locking), the codeblock looks like this:
![image](/uploads/fee834fbe8e928c99a48435f84af4611/image.png)
There are clearly extra blank lines between the code lines.e.g. in [fcntl.2](https://man.archlinux.org/man/fcntl.2.en#Advisory_record_locking), the codeblock looks like this:
![image](/uploads/fee834fbe8e928c99a48435f84af4611/image.png)
There are clearly extra blank lines between the code lines.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/42mandoc v.s. man-db?2023-03-24T07:11:26ZFranklin Yumandoc v.s. man-db?`man-db` seems more popular among the Linux community. Was the choice of `mandoc` an explicit decision, or was it simply a random choice? Does the Arch community prefer one over the other?`man-db` seems more popular among the Linux community. Was the choice of `mandoc` an explicit decision, or was it simply a random choice? Does the Arch community prefer one over the other?https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/43[Enhancement] Add "source" link to man source file (like manned.org)2024-03-02T12:40:43ZSebastian Carlos[Enhancement] Add "source" link to man source file (like manned.org)Would it be possible to add a "source" link that, when clicked, redirects to an URL that displays (or downloads) the raw source man file (in troff format)?
This is done by [manned.org](https://manned.org/). For example, the https://mann...Would it be possible to add a "source" link that, when clicked, redirects to an URL that displays (or downloads) the raw source man file (in troff format)?
This is done by [manned.org](https://manned.org/). For example, the https://manned.org/ls.1 page has a "SOURCE" link on the header that goes to https://manned.org/raw/ls.1
This feature is also on the [Debian Online Man pages](https://manpages.debian.org/bullseye/coreutils/ls.1.en.html). If you are on [bullseye/coreutils/ls.1.en.html](https://manpages.debian.org/bullseye/coreutils/ls.1.en.html), the link called "raw man page" takes you to [bullseye/coreutils/ls.1.en.gz](https://manpages.debian.org/bullseye/coreutils/ls.1.en.gz)
On [Ubuntu](https://manpages.ubuntu.com/manpages/kinetic/en/man1/ls.1.html) it's just a download link with the raw file name.https://gitlab.archlinux.org/archlinux/archmanweb/-/issues/45--opt=[x]NUM syntax breaks rendering of the first bracket2024-03-02T12:57:22ZMartin Rys--opt=[x]NUM syntax breaks rendering of the first bracketThis shows fine:
`-f, --follow[={name|descriptor}]`
This shows as *[*\+]:
`-n, --lines=[+]NUM`
Can be seen on https://man.archlinux.org/man/tail.1.en#cThis shows fine:
`-f, --follow[={name|descriptor}]`
This shows as *[*\+]:
`-n, --lines=[+]NUM`
Can be seen on https://man.archlinux.org/man/tail.1.en#c