Mac: Added documentation for customizing launch daemon startup.

osx/JenkinsInstaller.pmdoc/04jenkins-contents.xml

+<pkg-contents spec="1.12"><f n="Jenkins" o="root" g="admin" p="16893" pt="/Users/sami/Documents/Projektit/jenkins/osx/Library/Documentation/Jenkins" m="true" t="file"><f n=".DS_Store" o="root" g="admin" p="33204" x="true"><mod>mode</mod></f><f n="command-line-preferences.html" o="root" g="admin" p="33204"><mod>mode</mod><mod>group</mod><mod>owner</mod></f><mod>mode</mod><mod>group</mod><mod>owner</mod></f></pkg-contents>
\ No newline at end of file

osx/JenkinsInstaller.pmdoc/04jenkins.xml

+<pkgref spec="1.12" uuid="C24B9DDB-3A48-4BCB-9FAF-F45FB0CEBC83"><config><identifier>org.jenkins-ci.documentation.pkg</identifier><version>1.0</version><description/><post-install type="none"/><requireAuthorization/><installFrom relative="true" includeRoot="true">Library/Documentation/Jenkins</installFrom><installTo mod="true">/Library/Documentation</installTo><flags><followSymbolicLinks/></flags><packageStore type="internal"/><mod>installFrom.isRelativeType</mod><mod>installTo.path</mod><mod>includeRoot</mod><mod>identifier</mod><mod>parent</mod><mod>installTo</mod></config><contents><file-list>04jenkins-contents.xml</file-list><filter>/CVS$</filter><filter>/\.svn$</filter><filter>/\.cvsignore$</filter><filter>/\.cvspass$</filter><filter>/\.DS_Store$</filter></contents></pkgref>
\ No newline at end of file

osx/JenkinsInstaller.pmdoc/index.xml

-<pkmkdoc spec="1.12"><properties><title>Jenkins CI Server</title><build>/Users/irichter/Desktop/Jenkins.pkg</build><organization>org.jenkins-ci</organization><userSees ui="both"/><min-target os="3"/><domain system="true"/></properties><distribution><versions min-spec="1.000000"/><scripts></scripts></distribution><description>The Jenkins continuous integration server.</description><contents><choice title="Jenkins" id="jenkins-war" tooltip="jenkins.war file" description="The jenkins.war file." starts_selected="true" starts_enabled="false" starts_hidden="false"><pkgref id="org.jenkins-ci.jenkins.osx.pkg"/></choice><choice title="Launchd Daemon" id="jenkins-launchd" tooltip="Launchd Daemon for Jenkins" description="Installs a LaunchDaemon for Jenkins so Jenkins will start at boot" starts_selected="true" starts_enabled="true" starts_hidden="false"><pkgref id="org.jenkins-ci.launchd.pkg"/></choice><choice title="Jenkins Support Files" id="choice6" tooltip="Support files for Jenkins" description="Contains files required by the Launch Daemon." starts_selected="true" starts_enabled="true" starts_hidden="false"><pkgref id="org.jenkins-ci.support.pkg"/></choice></contents><resources bg-scale="none" bg-align="bottomleft"><locale lang="en"><resource relative="true" mod="true" type="background">artwork/banner-200.png</resource><resource relative="true" mod="true" type="license">docs/Jenkins-LICENSE.txt</resource><resource relative="true" mod="true" type="welcome">docs/JenkinsWelcomePanel.rtf</resource></locale></resources><flags/><postinstall><action id="com.apple.packagemaker.actions.showfile"><value>/Users/Shared/Jenkins/Home</value><type>absolute-path</type></action></postinstall><extra-files/><item type="file">01jenkins.xml</item><item type="file">02org.xml</item><item type="file">03jenkins.xml</item><mod>description</mod><mod>properties.title</mod><mod>properties.anywhereDomain</mod><mod>properties.userDomain</mod><mod>properties.customizeOption</mod><mod>extraFiles</mod><mod>postinstallActions.actions</mod><mod>properties.systemDomain</mod></pkmkdoc>
\ No newline at end of file
+<pkmkdoc spec="1.12"><properties><title>Jenkins CI Server</title><build>/Users/irichter/Desktop/Jenkins.pkg</build><organization>org.jenkins-ci</organization><userSees ui="both"/><min-target os="3"/><domain system="true"/></properties><distribution><versions min-spec="1.000000"/><scripts></scripts></distribution><description>The Jenkins continuous integration server.</description><contents><choice title="Jenkins" id="jenkins-war" tooltip="jenkins.war file" description="The jenkins.war file." starts_selected="true" starts_enabled="false" starts_hidden="false"><pkgref id="org.jenkins-ci.jenkins.osx.pkg"/></choice><choice title="Launchd Daemon" id="jenkins-launchd" tooltip="Launchd Daemon for Jenkins" description="Installs a LaunchDaemon for Jenkins so Jenkins will start at boot" starts_selected="true" starts_enabled="true" starts_hidden="false"><pkgref id="org.jenkins-ci.launchd.pkg"/></choice><choice title="Jenkins Support Files" id="choice6" tooltip="Support files for Jenkins" description="Contains files required by the Launch Daemon." starts_selected="true" starts_enabled="true" starts_hidden="false"><pkgref id="org.jenkins-ci.support.pkg"/></choice><choice title="Documentation" id="choice8" tooltip="Jenkins documentation" description="Document files installed into /Library/Documentation/Jenkins" starts_selected="true" starts_enabled="true" starts_hidden="false"><pkgref id="org.jenkins-ci.documentation.pkg"/></choice></contents><resources bg-scale="none" bg-align="bottomleft"><locale lang="en"><resource relative="true" mod="true" type="background">artwork/banner-200.png</resource><resource relative="true" mod="true" type="license">docs/Jenkins-LICENSE.txt</resource><resource relative="true" mod="true" type="welcome">docs/JenkinsWelcomePanel.rtf</resource></locale></resources><flags/><postinstall><action id="com.apple.packagemaker.actions.showfile"><value>/Users/Shared/Jenkins/Home</value><type>absolute-path</type></action></postinstall><extra-files/><item type="file">01jenkins.xml</item><item type="file">02org.xml</item><item type="file">03jenkins.xml</item><item type="file">04jenkins.xml</item><mod>description</mod><mod>properties.title</mod><mod>properties.systemDomain</mod><mod>properties.userDomain</mod><mod>properties.customizeOption</mod><mod>extraFiles</mod><mod>postinstallActions.actions</mod><mod>properties.anywhereDomain</mod></pkmkdoc>
\ No newline at end of file

osx/Library/Documentation/Jenkins/command-line-preferences.html

+<html>
+<head>
+<title>Jenkins command-line preferences</title>
+</head>
+<body>
+<h1>Jenkins command-line preferences</h1>
+
+<p><a href="https://wiki.jenkins-ci.org/display/JENKINS/Starting+and+Accessing+Jenkins">The Jenkins Wiki page</a> tells you how to change settings like which port number Jenkins will listen to. These settings need to be specified on the command line when Jenkins is started.
+
+<h4>Launch daemon</h4>
+
+<p>For the Mac, Jenkins is deployed as a launch daemon. (If you want to know more about launchd and daemons, see <a href="http://developer.apple.com/library/mac/#technotes/tn2083/_index.html">here</a> and <a href="http://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPSystemStartup/Articles/LaunchOnDemandDaemons.html">here</a>)
+
+<p>The launch daemon picks up the command line options from a standard preferences file, <tt>/Library/Preferences/org.jenkins-ci.plist</tt>. If the file does not exist, built-in defaults are used. The preference files are manipulated using the standard utility <tt>defaults</tt>.
+
+<h4>How To Use the defaults Command</h4>
+
+<p>To view all settings in the file, run:
+<tt>defaults read /Library/Preferences/org.jenkins-ci</tt>
+
+<p>To get the value of a single setting, run:
+<tt>defaults read /Library/Preferences/org.jenkins-ci SETTING</tt>
+
+<p>To set the value of a setting, run:
+<tt>defaults write /Library/Preferences/org.jenkins-ci SETTING VALUE</tt>
+
+<p>For more information, see <tt>man defaults</tt>
+
+<h4>Supported Settings</h4>
+
+<p>The list of settings supported by the Jenkins launch daemon (see <a href="http://winstone.sourceforge.net/#commandLine">documentation</a>):
+
+<ul>
+<li>prefix
+<li>httpPort
+<li>httpListenAddress
+<li>httpsPort
+<li>httpsListenAddress
+<li>ajp13Port
+<li>ajp13ListenAddress
+</ul>
+
+<p>Additionally, you can set also these:
+
+<ul>
+  <li>war (Full path name to jenkins.war file.)
+  <li>heapSize (Passed to java command-line -Xmx parameter.)
+  <li>JENKINS_HOME (Full path to JENKINS_HOME directory where Jenkins
+  keeps its files)
+</ul>
+  
+
+</body>
+</html>