User Tools

Site Tools


documentationandpackages

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
documentationandpackages [2015/05/10 04:19]
jacobadams [Missing man-pages]
documentationandpackages [2021/03/29 22:48] (current)
marceloalencar Fix broken link
Line 1: Line 1:
 +====== Documentation And Packages ======
 +
 +There are two areas where Minix has some catching up to do: documentation and packages. They provide many small projects, for which not much prior knowledge of Minix is required, which provide a good way to get started with Minix development,​ and the results of which would be highly valuable to the Minix project.
 +
 +If you want to contribute, please pick a package or man-page below, put your name behind it, and see whether you can fix it. Please take on only one project at a time, so as not to block others who want to work on these projects.
 +
 +Thanks for your help!
 +
 +===== Missing man-pages =====
 +Below is a list of man-pages that are missing. Only utility programs are listed currently, but functions of the MINIX API might be listed later. Please consult the source code when writing a man-page. Some utilities may have more, less, or different features than they do on other operating systems or in the POSIX specification. Make sure, however, that what is written in the man-page corresponds to the functionality in the version that is included in Minix.
 +^ Man-page for           ^ Person working on ^ Status |
 +|commands/​devmand ​       |                   ​| ​       |
 +|commands/​fix ​           |  Jacob Adams      | Pull Request #41        |
 +|commands/​rotate ​        ​| ​ Jacob Adams      |Committed (0805ab8c)|
 +|commands/​sprofalyze ​    ​| ​ Jacob Adams      | Pull Request #70       |
 +|commands/​sprofdiff ​     |  Jacob Adams      | Pull Request #71       |
 +|commands/​swifi ​         |                   ​| ​       |
 +|commands/​writeisofs ​    ​| ​                  ​| ​       |
 +
 +===== Process for the contribution of man-pages =====
 +
 +Find a tool that's not documented or whose documentation could be improved ​
 +Then just learn how it works and write the page. There are tons of examples in Minix already. ​
 +
 +Just submit it as a standard pull request. ​
 +
 +Make sure to put your manpage in the same folder as the tool it documents and set the MAN variable in the Makefile (see the Makefiles for tools with man pages for examples) ​
 +
 +Don't forget to add your new page to distrib/​sets/​lists/​minix-man/​mi
 +
 +===== Out of Date Wiki Pages =====
 +As minix grows and changes, the wiki pages that describe it also need to grow and change. To find pages that need updating, you can start by doing a search for "​[[http://​wiki.minix3.org/​en/​Wishlist?​action=fullsearch&​context=180&​value=stale&​fullsearch=Text|Stale]]"​ in the text. Find a page to work on, bring the page up to date, and then remove the stale page notice.
 +
 +===== Packages =====
 +
 +pkgsrc contains over 10,000 packages, but only a few thousand packages build and run out of the box on Minix. The goal is to get as many packages as possible working in Minix. A good way to get started is to try installing your favourite software, and fix any packages or dependencies that don't compile/​work. There is a guide [[developersguide:​pkgsrcguide|here]] for contributing to pkgsrc.