Differences between revisions 25 and 33 (spanning 8 versions)
Revision 25 as of 2016-11-17 20:09:52
Size: 1885
Editor: TheAnarcat
Comment: move to gitlab, keep a sync'd copy on alioth
Revision 33 as of 2019-10-16 09:45:06
Size: 1142
Comment: Add information on how to report issues
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
https://manpages.debian.org/ is a service providing online manpages in HTML format for the public. https://manpages.debian.org/ is a service providing online manual pages for all Debian releases in HTML format for the public.
Line 7: Line 7:
<<Include(Services/Debian manpages archive,,editlink)>> <<Include(Services/Debian manpages archive,,from="=$",editlink)>>
Line 9: Line 9:
== Current implementation == = Deployment =
Line 11: Line 11:
The current `manpages.debian.org` service has been disabled by [[Teams/DSA]] because of performance issues. The source code is available in http://anonscm.debian.org/viewvc/ddp/man-cgi/ and was supposed to be migrated to a different host. The current `manpages.debian.org` service is powered by [[https://github.com/Debian/debiman|debiman]], running on `manziarly.debian.org`.
Line 13: Line 13:
== New implementation == Details on how to make changes to the site are in the [[https://manpages.debian.org/faq.html|FAQ]].
Line 15: Line 15:
The current codebase is being rewritten from scratch into a package called [[https://gitlab.com/anarcat/debmans|Debmans]] [[https://gitlab.com/anarcat/debmans/blob/master/DESIGN.md|DESIGN]] document for a discussion on the implementation. = Issues =
Line 17: Line 17:
At this point, the code can extract all files from a mirror efficiently and convert them to HTML. It has not been tested on a full mirror yet, because TheAnarcat is waiting for `manpages` group access and dependencies install (`setuptools` from backports and/or `python-click`, `python-apt` and `python-debian`). See the [[https://gitlab.com/anarcat/debmans/blob/master/TODO.md|TODO]] file for more information about the current status of the project and limitations.

For Debian maintainers not wishing to operate on the Gitlab platform, there is also a [[https://anonscm.debian.org/git/collab-maint/debmans.git|collab-maint repository]] that is synchronised with Gitlab every hour.

= Hardware =

The old service used to run on `glinka.debian.org`. [[Teams/DSA]] requested the service should be moved to `manziarly.debian.org`.
Issues can be reported directly in [[https://github.com/Debian/debiman/issues]]. There is also a virtual package `manpages.debian.org` in the Debian bug tracking system which can be used to report bugs: [[http://bugs.debian.org/manpages.debian.org]]
Line 27: Line 21:
Discussions about manpages.debian.org can take place on the regular [[Teams/DDP]] channels, for example the `#debian-doc` IRC channel and `debian-doc@lists.debian.org` mailing list. Discussions about manpages.debian.org takes place on the regular [[Teams/DDP]] channels, for example the `#debian-doc` IRC channel and `debian-doc@lists.debian.org` mailing list. If you have any question on the service please use these regular channels.
Line 29: Line 23:
You can also subscribe to this wiki page to get updates, which also functions as a ad-hoc forum. You can also subscribe to this wiki page to get updates, which also functions as an ad-hoc forum.

https://manpages.debian.org/ is a service providing online manual pages for all Debian releases in HTML format for the public.

Current status

Deployment

The current manpages.debian.org service is powered by debiman, running on manziarly.debian.org.

Details on how to make changes to the site are in the FAQ.

Issues

Issues can be reported directly in https://github.com/Debian/debiman/issues. There is also a virtual package manpages.debian.org in the Debian bug tracking system which can be used to report bugs: http://bugs.debian.org/manpages.debian.org

Forum

Discussions about manpages.debian.org takes place on the regular Teams/DDP channels, for example the #debian-doc IRC channel and debian-doc@lists.debian.org mailing list. If you have any question on the service please use these regular channels.

You can also subscribe to this wiki page to get updates, which also functions as an ad-hoc forum.