[Mono-bugs] [Bug 74845][Wis] Changed - [OSX] no manpage for mcs

[bugzilla-daemon at bugzilla.ximian.com]

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

Changed by brion at pobox.com.

http://bugzilla.ximian.com/show_bug.cgi?id=74845

--- shadow/74845	2005-05-19 21:25:19.000000000 -0400
+++ shadow/74845.tmp.13393	2005-07-13 04:42:10.000000000 -0400
@@ -1,22 +1,21 @@
 Bug#: 74845
 Product: Mono: Runtime
 Version: 1.1
 OS: Mac OS X 10.3
 OS Details: 
-Status: NEW   
+Status: REOPENED   
 Resolution: 
 Severity: Unknown
 Priority: Wishlist
 Component: packaging
 AssignedTo: mono-bugs at ximian.com                            
 ReportedBy: darkmercenary at earthlink.net               
 QAContact: mono-bugs at ximian.com
 TargetMilestone: ---
 URL: 
-Cc: 
 Summary: [OSX] no manpage for mcs
 
 Please fill in this template when reporting a bug, unless you know what you
 are doing.
 Description of Problem:
 
@@ -33,6 +32,26 @@
 man page for mcs to appear
 
 How often does this happen? 
 every time
 
 Additional Information:
+
+------- Additional Comments From brion at pobox.com  2005-07-13 04:42 -------
+The man pages _are_ there but they are hidden away in Mono.framework. As a quick 
+manual hack you can add this line to ~/.profile to add them to the MANPATH:
+
+export MANPATH=$MANPATH:/Library/Frameworks/Mono.framework/Versions/Current/
+man
+
+The Mono.framework package installer makes symlinks of the binary executables into /
+usr/bin, following a similar convention as other Mac OS X packages such as the Java and 
+Python frameworks that Apple distributes. Apple's Java frameworks however also symlink 
+their manpages into /usr/share/man, so things like "man java" work as expected.
+
+If the executables are being symlinked, I think it makes a lot of sense to do the same for 
+the man pages to make a command-line usable by default -- particularly if the purpose of 
+this is to make it act like other native packages which do just that.
+
+(Mono 1.1.8.1 dmg installer on Mac OS X 10.4.1. Current Apple Java 1.4 and XCode 2.1 
+dev tools are installed.)
+