[MacPorts] NewHelpSystem modified

[MacPorts]

Changed page "NewHelpSystem" by raimue at macports.org from 91.11.239.21*
Page URL: <http://trac.macports.org/wiki/NewHelpSystem>
Diff URL: <http://trac.macports.org/wiki/NewHelpSystem?action=diff&version=3>
Revision 3

-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: NewHelpSystem
=========================================================================
--- NewHelpSystem (version: 2)
+++ NewHelpSystem (version: 3)
@@ -14,7 +14,7 @@
 
 As previous calls for participation to enhance `port help` went unheard, I am now proposing a different system inspired by git. The documentation will be available as man pages, therefore `port help <topic>` will become an alias of `man port-<topic>`. This means it can be easily accessed from the command line. Once the man pages are also available online, a new switch `port help --web <topic>` could open the requested topic in the browser instead for users preferring websites over man pages.
 
-Man pages will at least exist for all port commands, which will go into the man1 category. Splitting out certain topics from the current port(1) into their own man page to provide more details and examples will be considered, these will go into the man7 category.
+Man pages will at least exist for all port commands, which will go into the man1 category. Some similar port commands should be covered by the same man page, such as activate/deactivate, archive/unarchive, etc. Splitting out certain topics from the current port(1) into their own man page to provide more details and examples will be considered, these will go into the man7 category.
 
 == Changes for base developers == #developers
 

-------8<------8<------8<------8<------8<------8<------8<------8<--------

* The IP shown here might not mean anything if the user or the server is
behind a proxy.

--
MacPorts <http://www.macports.org/>
Ports system for Mac OS

This is an automated message. Someone at http://www.macports.org/ added your email
address to be notified of changes on NewHelpSystem. If it was not you, please
report to .