Revision: 134584 https://trac.macports.org/changeset/134584 Author: ionic@macports.org Date: 2015-03-30 17:38:57 -0700 (Mon, 30 Mar 2015) Log Message: ----------- doc-new/guide/xml: misc grammar fixes (remove the the duplicated words, badly designed headlines, etc.) Modified Paths: -------------- trunk/doc-new/guide/xml/portfile-phase.xml trunk/doc-new/guide/xml/portfile-startupitem.xml trunk/doc-new/guide/xml/portfiledev.xml trunk/doc-new/guide/xml/portgroup-python.xml trunk/doc-new/guide/xml/project.xml trunk/doc-new/guide/xml/using.xml Modified: trunk/doc-new/guide/xml/portfile-phase.xml =================================================================== --- trunk/doc-new/guide/xml/portfile-phase.xml 2015-03-31 00:38:47 UTC (rev 134583) +++ trunk/doc-new/guide/xml/portfile-phase.xml 2015-03-31 00:38:57 UTC (rev 134584) @@ -1035,7 +1035,7 @@ distribution files, filenames must be included to associate files with their checksums.</para> - <para>At least two checksum types (e.g., rmd160 and sha256) should be used to + <para>At least two checksum types (typically rmd160 and sha256) should be used to ensure the integrity of the distfiles.</para> <itemizedlist> Modified: trunk/doc-new/guide/xml/portfile-startupitem.xml =================================================================== --- trunk/doc-new/guide/xml/portfile-startupitem.xml 2015-03-31 00:38:47 UTC (rev 134583) +++ trunk/doc-new/guide/xml/portfile-startupitem.xml 2015-03-31 00:38:57 UTC (rev 134584) @@ -235,7 +235,7 @@ <title>Script StartupItems</title> <para>StartupItems of type <quote>script</quote> create a wrapper during - port installation for <command>daemondo</command> that that will be used + port installation for <command>daemondo</command> that will be used to launch a daemon startup script present in an application's source distribution (MacPorts does not create daemon startup scripts) for daemons that require a script.</para> Modified: trunk/doc-new/guide/xml/portfiledev.xml =================================================================== --- trunk/doc-new/guide/xml/portfiledev.xml 2015-03-31 00:38:47 UTC (rev 134583) +++ trunk/doc-new/guide/xml/portfiledev.xml 2015-03-31 00:38:57 UTC (rev 134584) @@ -1178,7 +1178,7 @@ <para>Thus the buildbot helps to keep MacPorts consistent on various OSX versions, i.e., a maintainer does not need access to these versions anymore in order to assure that the port(s) maintained build without problems. Currently only - the default port variants will be build and kept.</para> + the default port variants will be built and kept.</para> </section> Modified: trunk/doc-new/guide/xml/portgroup-python.xml =================================================================== --- trunk/doc-new/guide/xml/portgroup-python.xml 2015-03-31 00:38:47 UTC (rev 134583) +++ trunk/doc-new/guide/xml/portgroup-python.xml 2015-03-31 00:38:57 UTC (rev 134584) @@ -61,7 +61,7 @@ subport that will be installed if the user asks to install <quote>py-foo</quote> rather than, e.g., <quote>py26-foo</quote> or <quote>py27-foo</quote>. If not explicitly set, a reasonable default is chosen from the list in <code>python.versions</code>.</para> - <para>For apps (i.e., name does not start with <quote>py-</quote>), this chooses + <para>For applications (i.e., name does not start with <quote>py-</quote>), this chooses which version of python to use, and must be set. It can be changed in variants if desired.</para> @@ -102,7 +102,7 @@ <term>python.link_binaries_suffix</term> <listitem> - <para>Suffix to add the the names of the links created in + <para>Suffix to add to the names of the links created in <filename>${prefix}/bin</filename> when <varname>${python.link_binaries}</varname> is enabled. Can be cleared if no suffix is desired.</para> Modified: trunk/doc-new/guide/xml/project.xml =================================================================== --- trunk/doc-new/guide/xml/project.xml 2015-03-31 00:38:47 UTC (rev 134583) +++ trunk/doc-new/guide/xml/project.xml 2015-03-31 00:38:57 UTC (rev 134584) @@ -17,7 +17,7 @@ account to create tickets.</para> <section id="project.tickets.prerequisites"> - <title>Before you file a new ticket</title> + <title>Before Filing a New Ticket</title> <itemizedlist> <listitem> @@ -848,7 +848,7 @@ </listitem> <listitem> - <para>the identity you'd like to use as a member of the project, A.K.A. the + <para>the identity you'd like to use as a member of the project, a.k.a. the “handle”, as part of your <literal><replaceable>handle</replaceable>@macports.org</literal> alias.</para> </listitem> Modified: trunk/doc-new/guide/xml/using.xml =================================================================== --- trunk/doc-new/guide/xml/using.xml 2015-03-31 00:38:47 UTC (rev 134583) +++ trunk/doc-new/guide/xml/using.xml 2015-03-31 00:38:57 UTC (rev 134584) @@ -97,8 +97,8 @@ <para>The <option>sync</option> action performs a subset of <option>selfupdate</option>. It synchronizes the ports tree, as does <option>selfupdate</option>, but it does not check for MacPorts upgrades. On OS X, - unless there is a special reason not to do so, you should always run <link - linkend="using.port.selfupdate">selfupdate</link>.</para> + unless there is a special reason not to do so, run <link + linkend="using.port.selfupdate">selfupdate</link> instead.</para> <para><option>sync</option> does not accept any switches.</para> </section> @@ -530,11 +530,11 @@ <varlistentry> <term><option>--unrequested</option></term> <listitem> - <para>By default, each port you install using the <option>install</option> (vs. as a dependency - of a different port) is marked as <quote>requested</quote>. If you want MacPorts to treat - a port you installed manually as if it was automatically installed as a dependency (e.g., if - a dependency failed to build and you re-tried installing the dependency only), pass this - flag.</para> + <para>By default, each port you install using the <option>install</option> explicitly (contrary to ports + installed as a dependency of a different port) is marked as <quote>requested</quote>. + If you want MacPorts to treat a port you installed manually as if it was automatically installed + as a dependency (e.g., if a dependency failed to build and you re-tried installing the dependency only), + pass this flag.</para> </listitem> </varlistentry> </variablelist> @@ -1025,7 +1025,7 @@ <section id="using.variants.invoking"> <title>Invoking Variants</title> - <para>A variant can only be invoked when a port is installed. After you have determined what variants + <para>A variant can only be selected when a port is installed. After you have determined what variants a given port has, if any, you may install a port using the variant by specifying its name preceded by a plus or minus sign on the command line, for example</para>