Revision: 134585 https://trac.macports.org/changeset/134585 Author: ionic@macports.org Date: 2015-03-30 17:39:03 -0700 (Mon, 30 Mar 2015) Log Message: ----------- doc-new/guide/xml: markup fixes: move <para>paragraph</para> tags to the paragraph they belong to. Do not nest lists into paragraphs. Modified Paths: -------------- trunk/doc-new/guide/xml/installing.xml trunk/doc-new/guide/xml/project.xml Modified: trunk/doc-new/guide/xml/installing.xml =================================================================== --- trunk/doc-new/guide/xml/installing.xml 2015-03-31 00:38:57 UTC (rev 134584) +++ trunk/doc-new/guide/xml/installing.xml 2015-03-31 00:39:03 UTC (rev 134585) @@ -74,7 +74,7 @@ <para>If you are using Mac OS X 10.6, there are two branches of Xcode which could be considered to be the latest, 3.2.x and 4.x. Xcode 4 costs money, but Xcode 3 is still available free of charge. There are two - options for downloading it: + options for downloading it:</para> <orderedlist> <listitem> @@ -88,28 +88,27 @@ </listitem> </orderedlist> - Both are available from the <ulink url="https://developer.apple.com/downloads/index.action">Apple + <para>Both are available from the <ulink url="https://developer.apple.com/downloads/index.action">Apple developer website</ulink>. You may also be able to install Xcode 3.2 from your Mac OS X 10.6 DVD and then run Software Update to get the latest version.</para> <para>Ensure that those of the following options that are available in the installer for your version of - Xcode are selected: + Xcode are selected:</para> <itemizedlist> <listitem> - <guibutton>UNIX Development</guibutton> + <para><guibutton>UNIX Development</guibutton></para> </listitem> <listitem> - <guibutton>System Tools</guibutton> + <para><guibutton>System Tools</guibutton></para> </listitem> <listitem> - <guibutton>X11 SDK</guibutton> + <para><guibutton>X11 SDK</guibutton></para> </listitem> <listitem> - <guibutton>Command Line Support</guibutton> + <para><guibutton>Command Line Support</guibutton></para> </listitem> </itemizedlist> - </para> </section> <section id="installing.xcode.other"> @@ -120,23 +119,22 @@ <ulink url="https://developer.apple.com/downloads/index.action">Apple developer website</ulink>.</para> <para>Ensure that those of the following options that are available in the installer for your version of - Xcode are selected: + Xcode are selected:</para> <itemizedlist> <listitem> - <guibutton>UNIX Development</guibutton> + <para><guibutton>UNIX Development</guibutton></para> </listitem> <listitem> - <guibutton>System Tools</guibutton> + <para><guibutton>System Tools</guibutton></para> </listitem> <listitem> - <guibutton>X11 SDK</guibutton> + <para><guibutton>X11 SDK</guibutton></para> </listitem> <listitem> - <guibutton>Command Line Support</guibutton> + <para><guibutton>Command Line Support</guibutton></para> </listitem> </itemizedlist> - </para> </section> </section> @@ -177,7 +175,7 @@ OS X 10.10 Yosemite: </term> <listitem> - <ulink url="https://distfiles.macports.org/MacPorts/MacPorts-&macports-version;-10.10-Yosemite.pkg">MacPorts-&macports-version;-10.10-Yosemite.pkg</ulink> + <para><ulink url="https://distfiles.macports.org/MacPorts/MacPorts-&macports-version;-10.10-Yosemite.pkg">MacPorts-&macports-version;-10.10-Yosemite.pkg</ulink></para> </listitem> </varlistentry> <varlistentry> @@ -185,7 +183,7 @@ OS X 10.9 Mavericks: </term> <listitem> - <ulink url="https://distfiles.macports.org/MacPorts/MacPorts-&macports-version;-10.9-Mavericks.pkg">MacPorts-&macports-version;-10.9-Mavericks.pkg</ulink> + <para><ulink url="https://distfiles.macports.org/MacPorts/MacPorts-&macports-version;-10.9-Mavericks.pkg">MacPorts-&macports-version;-10.9-Mavericks.pkg</ulink></para> </listitem> </varlistentry> <varlistentry> @@ -193,7 +191,7 @@ OS X 10.8 Mountain Lion: </term> <listitem> - <ulink url="https://distfiles.macports.org/MacPorts/MacPorts-&macports-version;-10.8-MountainLion.pkg">MacPorts-&macports-version;-10.8-MountainLion.pkg</ulink> + <para><ulink url="https://distfiles.macports.org/MacPorts/MacPorts-&macports-version;-10.8-MountainLion.pkg">MacPorts-&macports-version;-10.8-MountainLion.pkg</ulink></para> </listitem> </varlistentry> </variablelist> Modified: trunk/doc-new/guide/xml/project.xml =================================================================== --- trunk/doc-new/guide/xml/project.xml 2015-03-31 00:38:57 UTC (rev 134584) +++ trunk/doc-new/guide/xml/project.xml 2015-03-31 00:39:03 UTC (rev 134585) @@ -31,8 +31,7 @@ <quote>Skipping completed</quote> in the log for each previously-completed phase that was skipped. Before filing a ticket, <userinput>sudo port clean</userinput> the port that - failed, then try again. - </para> + failed, then try again.</para> </listitem> <listitem> <para>Check the problem hotlist</para> @@ -48,13 +47,13 @@ <para>Search to see if a Trac ticket has already been filed</para> <para> Avoid filing duplicate bugs. Search for duplicates by: + </para> <itemizedlist> <listitem><para>using the search bar that appears on each page</para></listitem> <listitem><para>using <ulink url="https://trac.macports.org/search?portsummarysearch=on">the search page</ulink></para></listitem> <listitem><para>browsing the list of <ulink url="https://trac.macports.org/report">categorized reports</ulink></para></listitem> <listitem><para>making an advanced search by constructing a <ulink url="https://trac.macports.org/query">custom query</ulink></para></listitem> </itemizedlist> - </para> </listitem> <listitem> <para>Is the problem an application error and not related to compiling and installing?</para> @@ -757,15 +756,15 @@ <para>A port may be considered abandoned if any of the following apply:</para> <itemizedlist> - <listitem>A bug has not been acknowledged for more than three weeks - after a ticket is filed.</listitem> - <listitem>All tickets filed against the port have been resolved + <listitem><para>A bug has not been acknowledged for more than three weeks + after a ticket is filed.</para></listitem> + <listitem><para>All tickets filed against the port have been resolved with no input from the maintainer, after the 72-hour timeout, for a significant period of time (at least three weeks). This needs to involve a reasonable number of tickets; one timeout - doesn't make a port abandoned.</listitem> - <listitem>The listed maintainer address bounces, and no alternate way - of contacting the maintainer is known.</listitem> + doesn't make a port abandoned.</para></listitem> + <listitem><para>The listed maintainer address bounces, and no alternate way + of contacting the maintainer is known.</para></listitem> </itemizedlist> <para>If you wish to initiate the Port Abandonment protocol and optionally volunteer as the new maintainer:</para> @@ -870,9 +869,9 @@ Project. Its membership is usually determined by public elections among project members; the current members of the team can be found on the <ulink url="https://trac.macports.org/wiki/MacPortsDevelopers">MacPorts - Developers wiki page</ulink>. + Developers wiki page</ulink>.</para> - They are responsible for matters such as: + <para>They are responsible for matters such as:</para> <itemizedlist> <listitem> @@ -895,7 +894,7 @@ <listitem> <para>engineering releases.</para> </listitem> - </itemizedlist></para> + </itemizedlist> </section> </chapter>