[translation] Fwd: web/xml/users-guide uguide.en.xml,1.25,1.26

Good thing the mailserver is working now

Begin forwarded message:

> From: Alexander Hansen <[email protected]>
> Date: March 8, 2005 10:09:01 PM EST
> To: [email protected]
> Subject: web/xml/users-guide uguide.en.xml,1.25,1.26
> Reply-To: [email protected]
>
> Update of /cvsroot/fink/web/xml/users-guide
> In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv26925
>
> Modified Files:
> 	uguide.en.xml
> Log Message:
> Update chapter 6 to agree with "man fink" from 0.24.1
>
>
> Index: uguide.en.xml
> ===================================================================
> RCS file: /cvsroot/fink/web/xml/users-guide/uguide.en.xml,v
> retrieving revision 1.25
> retrieving revision 1.26
> diff -u -d -r1.25 -r1.26
> --- uguide.en.xml	7 Mar 2005 01:11:54 -0000	1.25
> +++ uguide.en.xml	9 Mar 2005 03:08:57 -0000	1.26
> @@ -1130,7 +1130,7 @@
>             Specify a notification plugin to tell you when packages 
> have been
>             installed/uninstalled.  Defaults to Growl (requires 
> <code>Mac::Growl</code> to
>             operate).  Other plugins can be found in the
> -           <filename><![CDATA[]]>/sw/lib/perl5/Fink/Notify</filename> 
> directory.
> +           <filename>/sw/lib/perl5/Fink/Notify</filename> directory.
>  </p></li>
>        </ul>
>      </section>
> @@ -1197,27 +1197,38 @@
>        <title>Global options</title>
>        <p>
>  There are some options, which apply to all fink commands. If you
> -type <code>fink --help</code> you get the list of options:
> +type <code>fink --help</code> you get the list of options:
>        </p>
> -      <codeblock>
> --h, --help            - display this help text
> +      <p>(as of <code>fink-0.24.1</code>)</p>
> +      <codeblock>-h, --help            - display this help text
>  -q, --quiet           - causes fink to be less verbose, opposite of 
> --verbose
>  -V, --version         - display version information
>  -v, --verbose         - causes fink to be more verbose, opposite of 
> --quiet
> --y, --yes             - assume default answer for all interactive 
> questions
> +-y, --yes             - assume default answer for all interactive 
> questio
>  -b, --use-binary-dist - download pre-compiled packages from the binary
> -                          distribution if available
> -      </codeblock>
> +                        distribution if available (e.g. to reduce 
> compile
> +		       time or disk usage).
> +		        Note that this mode instructs Fink to download the
> +                        version it wants if that version is available 
> for
> +		        download; it does not cause Fink to choose a version
> +    		        based on its binary availability.
> +--no-use-binary-dist  - Don't use pre-compiled binary packages from 
> the
> +                        binary distribution (opposite of 
> --use-binary-dist)
> +-K, --keep-root-dir   - Causes Fink not to delete the
> +                        /sw/src/root-[name]-[version]-[revision]
> +		        directory after building a package.
> +-k, --keep-build-dir  - Causes Fink not to delete the
> +                        /sw/src/[name]-[version]-[revision]
> +                        directory after building a package.
> +--build-as-nobody     - Drop to a non-root user when performing the 
> unpack,
> +                        patch, compile,and install phases. Note that 
> packages
> +                        built with this option may be non-functional. 
> You
> +                        should use this mode for package development
> +                        and debugging only.ns</codeblock>
>        <p>
>  Most of these options are self-explanatory. They can also be set in 
> the
>  <xref chapter="conf">Fink configuration file</xref> (fink.conf) if 
> you want
> -to set them permanently and not just for that invocation of 
> <code>fink</code>.
> -      </p>
> -      <p>
> -The <code>--use-binary-dist</code> option causes <code>fink</code> to 
> try to
> -download pre-compiled binary packages from the binary distribution if 
> available
> -and if the binary package is not already on the system. (Only 
> available as of <code>fink</code> version 0.23.0)
> -      </p>
> +to set them permanently and not just for that invocation of 
> <code>fink</code>.</p>
>      </section>
>      <section name="install">
>        <title>install</title>
> @@ -1232,17 +1243,13 @@
>  The following additional package will be installed:
>   lesstif
>  Do you want to continue? [Y/n]</codeblock>
> -      <p>
> -If you add the <xref section="options">--use-binary-dist option</xref>
> -<code>fink</code> will try to download binary packages, if available, 
> instead
> -of building them. This can save a lot of installation time.
> -      </p>
> +      <p>Use of the <xref section="options">--use-binary-dist</xref> 
> option with <code>fink install</code> can speed the build process for 
> complicated packages by quite a lot.</p>
>        <p>Aliases for the install command: update, enable, activate, 
> use (most
>  of these for historic reasons).</p>
>      </section>
>      <section name="remove">
>        <title>remove</title>
> -      <p>The remove command removes packages from the system by 
> calling '<code>dpkg --remove</code>'. The current implementation has a 
> flaw: it
> +      <p>The remove command removes packages from the system by 
> calling '<code>dpkg --remove</code>'. The current default 
> implementation has a flaw: it
>  doesn't check dependencies itself but rather completely leaves that to
>  the dpkg tool (usually this poses no problem, though).</p>
>        <p>The remove command only removes the actual package files,
> @@ -1251,6 +1258,11 @@
>  re-install the package later without going through the compile process
>  again. If you need the disk space, you can remove the .deb from the
>  <filename>/sw/fink/dists</filename> tree.</p>
> +      <p>These flags can be used with the fink remove command
> +</p>
> +      <codeblock>-h,--help             - Show the options which are 
> available.
> +-r,--recursive        - Also remove packages that depend on the 
> package(s) to
> +                        be removed (i.e. overcome the above-mentioned 
> flaw).</codeblock>
>        <p>Aliases: disable, deactivate, unuse, delete.</p>
>      </section>
>      <section name="purge">
> @@ -1258,16 +1270,17 @@
>        <p>The purge command purges packages from the system. This is
>  the same as the remove command except that it removes configuration
>  files as well.</p>
> +      <p>This command takes the:</p>
> +      <codeblock>-h,--help
> +-r,--recursive</codeblock>
> +      <p>options.</p>
>      </section>
>      <section name="update-all">
>        <title>update-all</title>
>        <p>This command updates all installed packages to the latest 
> version. It
>  does not need a package list, so you just type:</p>
>        <codeblock>fink update-all</codeblock>
> -      <p>
> -The <xref section="options">--use-binary-dist option</xref> is also
> -applicable here.
> -      </p>
> +      <p><xref section="options">--use-binary-dist</xref> is also 
> useful with this command.</p>
>      </section>
>      <section name="list">
>        <title>list</title>
> @@ -1287,7 +1300,7 @@
>       not installed
>   i   latest version is installed
>  (i)  installed, but a newer version is available
> -</codeblock>
> + p   a virtual package provided by a package that is 
> installed</codeblock>
>        <p>
>  There are also some flags for the <code>fink list</code> command
>  </p>
> @@ -1308,6 +1321,12 @@
>  -s=expr,--section=expr
>  	  Show only packages in the sections matching the regular
>  	  expression expr.
> +-m expr,--maintainer=expr
> +          Show only packages with the maintainer  matching the
> +          regular expression expr.
> +-t expr,--tree=expr
> +          Show only packages in the trees matching the regular
> +          expression expr.
>  -w=xyz,--width=xyz
>  	  Sets the width of the display you would like the output
>  	  formatted for. xyz is either a numeric value or auto.
> @@ -1361,13 +1380,21 @@
>      </section>
>      <section name="fetch-all">
>        <title>fetch-all</title>
> -      <p>Downloads <em>all</em> package source files. Like fetch, 
> this downloads the
> +      <p>Downloads <em>all</em> package source files. 
> Like<code>fetch</code>, this downloads the
>  tarballs even when they were downloaded before.</p>
> +      <p>These flags can be used with the <code>fink fetch-all</code> 
> command:</p>
> +      <codeblock>-h,--help
> +-i,--ignore-restrictive
> +-d,--dry-run</codeblock>
>      </section>
>      <section name="fetch-missing">
>        <title>fetch-missing</title>
>        <p>Downloads <em>all</em> missing package source files. This 
> command will only download
>  files that are not present on the system.</p>
> +      <p>These flags can be used with the <code>fink 
> fetch-missing</code> command:</p>
> +      <codeblock>-h,--help
> +-i,--ignore-restrictive
> +-d,--dry-run</codeblock>
>      </section>
>      <section name="build">
>        <title>build</title>
> @@ -1387,9 +1414,6 @@
>  the existing .deb file. If the package is installed, the newly created
>  .deb file will also be installed in the system via <code>dpkg</code>. 
> Very useful
>  during package development.</p>
> -      <p>
> -The <xref section="options">--use-binary-dist option</xref> is 
> applicable here.
> -      </p>
>      </section>
>      <section name="reinstall">
>        <title>reinstall</title>
> @@ -1434,8 +1458,14 @@
>        <p>
>     This command performs various checks on .info and .deb files. 
> Package
>     maintainers should run this on their package descriptions and
> -   corresponding built packages before submitting them.
> -</p>
> +   corresponding built packages before submitting them.</p>
> +      <p>The following optional options may be used:</p>
> +      <codeblock>-h,--help            - Show the options which are 
> available.
> +-p,--prefix          - Simulate an alternate Fink basepath prefix 
> (%p) within
> +                      the files being validated.
> +--pedantic, --no-pedantic
> +                     - Control the display of nitpicky formatting 
> warnings.
> +                      --pedantic is the default.</codeblock>
>        <p>
>     Aliases: check
>  </p>
> @@ -1454,7 +1484,7 @@
>  </p>
>        <p>
>  If the <xref section="options">--use-binary-dist option</xref> is 
> enabled
> -obsolete downloaded binary packages are also deleted.
> +obsolete downloaded binary packages are also deleted and <code>fink 
> scanpackages</code> is run as well.
>        </p>
>      </section>
>      <section name="dumpinfo">
> @@ -1478,6 +1508,22 @@
>     --percent=key       in the order listed.
>        </codeblock>
>      </section>
> +    <section name="show-deps">
> +      <title>show-deps</title>
> +      <p>Only available in fink-0.23-6 and later.</p>
> +      <p>Shows how Fink parses parts of a package's .info file. 
> Various fields and percent expansions will be displayed according to 
> options as follows:</p>
> +      <codeblock>-h,--help            - Show the options which are 
> available.
> +-a,--all             - Display all fields from the package 
> description.  This
> +                       is the default mode when no --field or 
> --percent flags
> +                       are given.
> +-f fieldname, --field=fieldname
> +                     - Display the given fieldname(s), in the order 
> listed.
> +-p key, --percent=key
> +                     - Display the given percent expansion key(s), in 
> the
> +                      order listed.
> +</codeblock>
> +      <p></p>
> +    </section>
>      <!-- 'fink snapshot' will not be included in 0.24
>      <section name="snapshot">
>        <title>snapshot</title>
>
>
>
> -------------------------------------------------------
> SF email is sponsored by - The IT Product Guide
> Read honest & candid reviews on hundreds of IT Products from real 
> users.
> Discover which products truly live up to the hype. Start reading now.
> http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
> _______________________________________________
> Fink-commits mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/fink-commits