Update of /cvsroot/fink/web/doc/users-guide
In directory sc8-pr-cvs5.sourceforge.net:/tmp/cvs-serv23473/web/doc/users-guide
Modified Files:
conf.en.php index.en.php install.en.php intro.en.php
packages.en.php uguide.en.html upgrade.en.php usage.en.php
Log Message:
Update user's guide for new fink features.
Index: usage.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/users-guide/usage.en.php,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -d -r1.42 -r1.43
--- usage.en.php 24 Sep 2006 00:32:54 -0000 1.42
+++ usage.en.php 12 Dec 2006 18:52:38 -0000 1.43
@@ -1,7 +1,7 @@
<?
$title = "User's Guide - fink Tool";
$cvs_author = 'Author: alexkhansen';
-$cvs_date = 'Date: 2006/09/23 23:52:44';
+$cvs_date = 'Date: 2006/12/12 18:40:18';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="User\'s
Guide Contents"><link rel="prev" href="conf.php?phpLang=en" title="The Fink
Configuration File">';
@@ -26,7 +26,7 @@
There are some options, which apply to all fink commands. If you
type <code>fink --help</code> you get the list of options:
</p>
- <p>(as of <code>fink-0.24.6</code>)</p>
+ <p>(as of <code>fink-0.26.0</code>)</p>
<p><b>-h, --help</b> - displays help text.
</p>
<p><b>-q, --quiet</b> - causes <code>fink</code> to be less verbose,
opposite of <b>--verbose</b>. Overrides the <a
href="conf.php?phpLang=en#optional">Verbose</a> flag in <code>fink.conf</code>.
@@ -67,7 +67,15 @@
<p><b>-m, --maintainer</b>
- (<code>fink-0.25</code> and later) Perform actions useful to
package maintainers: run validation on
the <code>.info</code> file before building and on the
<code>.deb</code> after building a
- package; turn certain build-time warnings into fatal errors.</p>
+ package; turn certain build-time warnings into fatal errors;
(<code>fink-0.26</code> and later) run the test suites as specified in the
field. This sets <b>--tests</b> and <b>--validate</b> to <code>on</code>.</p>
+ <p><b>--tests[=on|off|warn]</b> - (<code>fink-0.26.0</code> and
later) Causes <code>InfoTest</code> fields to be activated and test suites
specified
+ via <code>TestScript</code> to be executed (see the <a
href="../packaging/reference.php#fields">Fink Packaging Manual</a>). If no
argument is given to this
+ option or if the argument is <code>on</code> then failures in test
suites will
+ be considered fatal errors during builds. If the argument is
<code>warn</code>
+ then failures will be treated as warnings.</p>
+ <p><b>--validate[=on|off|warn]</b> -
+ Causes packages to be validated during a build. If no argument is
+ given to this option or if the argument is <code>on</code> then
validation failures will be considered fatal errors during builds. If the
argument is <code>warn</code> then failures will be treated as warnings.</p>
<p><b>-l, --log-output</b>
- Save a copy of the terminal output during each package building
process. By default, the file is stored in
@@ -366,6 +374,7 @@
This will let you change your mirror sites and proxy settings, among
others.
</p>
+ <p><b>New in</b> <code>fink-0.26.0</code>: This command will also let
you turn on the unstable trees if desired.</p>
<h2><a name="selfupdate">6.18 selfupdate</a></h2>
@@ -427,9 +436,9 @@
<h2><a name="cleanup">6.24 cleanup</a></h2>
<p>
- Removes obsolete package files (.info, .patch, .deb) if newer versions are
available.
- This can reclaim large amounts of disk space. One or more modes must be
specified:</p>
-<pre>--debs - Delete .deb files (compiled binary package
archives)
+ Removes obsolete and temporary files.
+ This can reclaim large amounts of disk space. One or more modes may be
specified:</p>
+ <pre>--debs - Delete .deb files (compiled binary package
archives)
corresponding to versions of packages that are neither
described by a package description (.info) file in the
currently-active trees nor presently installed.
@@ -438,9 +447,13 @@
active trees.
--buildlocks, --bl - Delete stale buildlock packages.
--dpkg-status - Remove entries for packages that are not installed from
- the dpkg "status" database.</pre>
-<p>In addition, the following options may be used:</p>
-<pre>-k,--keep-src - Move old source files to /sw/src/old/ instead of
deleting them.
+ the dpkg "status" database.
+--obsolete-packages - Attempt to uninstall all installed packges that are
+ obsolete. (new in fink-0.26.0)
+--all - All of the above modes. (new in fink-0.26.0)</pre>
+ <p>If no mode is specified, <code>--debs --sources</code> is the default
action. </p>
+ <p>In addition, the following options may be used:</p>
+ <pre>-k,--keep-src - Move old source files to /sw/src/old/
instead of deleting them.
-d,--dry-run - Print the names of the files that would be deleted, but
do not actually delete them.
-h,--help - Show the modes and options which are available.</pre>
Index: conf.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/users-guide/conf.en.php,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -d -r1.43 -r1.44
--- conf.en.php 24 Sep 2006 00:32:54 -0000 1.43
+++ conf.en.php 12 Dec 2006 18:52:37 -0000 1.44
@@ -1,7 +1,7 @@
<?
$title = "User's Guide - fink.conf";
$cvs_author = 'Author: alexkhansen';
-$cvs_date = 'Date: 2006/09/23 23:52:44';
+$cvs_date = 'Date: 2006/12/12 18:40:18';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="User\'s
Guide Contents"><link rel="next" href="usage.php?phpLang=en" title="Using the
fink Tool from the Command Line"><link rel="prev" href="upgrade.php?phpLang=en"
title="Upgrading Fink">';
Index: intro.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/users-guide/intro.en.php,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -d -r1.42 -r1.43
--- intro.en.php 24 Sep 2006 00:32:54 -0000 1.42
+++ intro.en.php 12 Dec 2006 18:52:38 -0000 1.43
@@ -1,7 +1,7 @@
<?
$title = "User's Guide - Introduction";
$cvs_author = 'Author: alexkhansen';
-$cvs_date = 'Date: 2006/09/23 23:52:44';
+$cvs_date = 'Date: 2006/12/12 18:40:18';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="User\'s
Guide Contents"><link rel="next" href="install.php?phpLang=en" title="First
Time Installation"><link rel="prev" href="index.php?phpLang=en" title="User\'s
Guide Contents">';
Index: packages.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/users-guide/packages.en.php,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -d -r1.47 -r1.48
--- packages.en.php 24 Sep 2006 00:32:54 -0000 1.47
+++ packages.en.php 12 Dec 2006 18:52:38 -0000 1.48
@@ -1,7 +1,7 @@
<?
$title = "User's Guide - Packages";
$cvs_author = 'Author: alexkhansen';
-$cvs_date = 'Date: 2006/09/23 23:52:44';
+$cvs_date = 'Date: 2006/12/12 18:40:18';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="User\'s
Guide Contents"><link rel="next" href="upgrade.php?phpLang=en" title="Upgrading
Fink"><link rel="prev" href="install.php?phpLang=en" title="First Time
Installation">';
Index: index.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/users-guide/index.en.php,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -d -r1.48 -r1.49
--- index.en.php 24 Sep 2006 00:32:54 -0000 1.48
+++ index.en.php 12 Dec 2006 18:52:37 -0000 1.49
@@ -1,7 +1,7 @@
<?
$title = "User's Guide";
$cvs_author = 'Author: alexkhansen';
-$cvs_date = 'Date: 2006/09/23 23:52:44';
+$cvs_date = 'Date: 2006/12/12 18:40:18';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="User\'s
Guide Contents"><link rel="next" href="intro.php?phpLang=en"
title="Introduction">';
@@ -29,7 +29,7 @@
<li><a href="intro.php?phpLang=en"><b>1 Introduction</b></a><ul><li><a
href="intro.php?phpLang=en#what">1.1 What is Fink?</a></li><li><a
href="intro.php?phpLang=en#req">1.2 Requirements</a></li><li><a
href="intro.php?phpLang=en#supported-os">1.3 Supported Systems</a></li><li><a
href="intro.php?phpLang=en#src-vs-bin">1.4 Source vs.
Binary</a></li></ul></li><li><a href="install.php?phpLang=en"><b>2 First Time
Installation</b></a><ul><li><a href="install.php?phpLang=en#bin">2.1 Installing
the Binary Distribution</a></li><li><a href="install.php?phpLang=en#src">2.2
Installing the Source Distribution</a></li><li><a
href="install.php?phpLang=en#setup">2.3 Setting Up Your
Environment</a></li></ul></li><li><a href="packages.php?phpLang=en"><b>3
Installing Packages</b></a><ul><li><a
href="packages.php?phpLang=en#bin-dselect">3.1 Installing Binary Packages with
dselect</a></li><li><a href="packages.php?phpLang=en#bin-apt">3.2 Installing
Binary Packages with
apt-get</a></li><li><a href="packages.php?phpLang=en#bin-exceptions">3.3
Installing Dependent Packages that are Unavailable in the Binary
Distribution</a></li><li><a href="packages.php?phpLang=en#src">3.4 Installing
Binary and Source Packages with fink</a></li><li><a
href="packages.php?phpLang=en#fink-commander">3.5 Fink Commander</a></li><li><a
href="packages.php?phpLang=en#available-versions">3.6 Available
versions</a></li><li><a href="packages.php?phpLang=en#x11">3.7 Getting X11
Sorted Out</a></li></ul></li><li><a href="upgrade.php?phpLang=en"><b>4
Upgrading Fink</b></a><ul><li><a href="upgrade.php?phpLang=en#bin">4.1
Upgrading using Binary Packages</a></li><li><a
href="upgrade.php?phpLang=en#src">4.2 Upgrading the Source
Distribution</a></li><li><a href="upgrade.php?phpLang=en#mix">4.3 Mixing
Binaries and Source</a></li></ul></li><li><a href="conf.php?phpLang=en"><b>5
The Fink Configuration File</b></a><ul><li><a
href="conf.php?phpLang=en#about">5.1 About fink.conf</a></
li><li><a href="conf.php?phpLang=en#syntax">5.2 fink.conf
syntax</a></li><li><a href="conf.php?phpLang=en#required">5.3 Required
Settings</a></li><li><a href="conf.php?phpLang=en#optional">5.4 Optional User
Settings</a></li><li><a href="conf.php?phpLang=en#downloading">5.5 Download
Settings</a></li><li><a href="conf.php?phpLang=en#mirrors">5.6 Mirror
Settings</a></li><li><a href="conf.php?phpLang=en#developer">5.7 Developer
Settings</a></li><li><a href="conf.php?phpLang=en#advanced">5.8 Advanced
Settings</a></li><li><a href="conf.php?phpLang=en#sourceslist">5.9 Managing
apt's sources.list file</a></li></ul></li><li><a
href="usage.php?phpLang=en"><b>6 Using the fink Tool from the Command
Line</b></a><ul><li><a href="usage.php?phpLang=en#using">6.1 Using the fink
tool</a></li><li><a href="usage.php?phpLang=en#options">6.2 Global
options</a></li><li><a href="usage.php?phpLang=en#install">6.3
install</a></li><li><a href="usage.php?phpLang=en#remove">6.4
remove</a></li><li><a hre
f="usage.php?phpLang=en#purge">6.5 purge</a></li><li><a
href="usage.php?phpLang=en#update-all">6.6 update-all</a></li><li><a
href="usage.php?phpLang=en#list">6.7 list</a></li><li><a
href="usage.php?phpLang=en#apropos">6.8 apropos</a></li><li><a
href="usage.php?phpLang=en#describe">6.9 describe</a></li><li><a
href="usage.php?phpLang=en#plugins">6.10 plugins</a></li><li><a
href="usage.php?phpLang=en#fetch">6.11 fetch</a></li><li><a
href="usage.php?phpLang=en#fetch-all">6.12 fetch-all</a></li><li><a
href="usage.php?phpLang=en#fetch-missing">6.13 fetch-missing</a></li><li><a
href="usage.php?phpLang=en#build">6.14 build</a></li><li><a
href="usage.php?phpLang=en#rebuild">6.15 rebuild</a></li><li><a
href="usage.php?phpLang=en#reinstall">6.16 reinstall</a></li><li><a
href="usage.php?phpLang=en#configure">6.17 configure</a></li><li><a
href="usage.php?phpLang=en#selfupdate">6.18 selfupdate</a></li><li><a
href="usage.php?phpLang=en#selfupdate-rsync">6.19
selfupdate-rsync</a></li><li><a
href="usage.php?phpLang=en#selfupdate-cvs">6.20 selfupdate-cvs</a></li><li><a
href="usage.php?phpLang=en#index">6.21 index</a></li><li><a
href="usage.php?phpLang=en#validate">6.22 validate</a></li><li><a
href="usage.php?phpLang=en#scanpackages">6.23 scanpackages</a></li><li><a
href="usage.php?phpLang=en#cleanup">6.24 cleanup</a></li><li><a
href="usage.php?phpLang=en#dumpinfo">6.25 dumpinfo</a></li><li><a
href="usage.php?phpLang=en#show-deps">6.26 show-deps</a></li></ul></li></ul>
-<!--Generated from $Fink: uguide.en.xml,v 1.44 2006/09/23 23:52:44 alexkhansen
Exp $-->
+<!--Generated from $Fink: uguide.en.xml,v 1.45 2006/12/12 18:40:18 alexkhansen
Exp $-->
<? include_once "../../footer.inc"; ?>
Index: install.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/users-guide/install.en.php,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -d -r1.43 -r1.44
--- install.en.php 24 Sep 2006 00:32:54 -0000 1.43
+++ install.en.php 12 Dec 2006 18:52:38 -0000 1.44
@@ -1,7 +1,7 @@
<?
$title = "User's Guide - Install";
$cvs_author = 'Author: alexkhansen';
-$cvs_date = 'Date: 2006/09/23 23:52:44';
+$cvs_date = 'Date: 2006/12/12 18:40:18';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="User\'s
Guide Contents"><link rel="next" href="packages.php?phpLang=en"
title="Installing Packages"><link rel="prev" href="intro.php?phpLang=en"
title="Introduction">';
Index: uguide.en.html
===================================================================
RCS file: /cvsroot/fink/web/doc/users-guide/uguide.en.html,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -d -r1.53 -r1.54
--- uguide.en.html 24 Sep 2006 00:32:54 -0000 1.53
+++ uguide.en.html 12 Dec 2006 18:52:38 -0000 1.54
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!--
-Generated from $Fink: uguide.en.xml,v 1.44 2006/09/23 23:52:44 alexkhansen Exp
$
+Generated from $Fink: uguide.en.xml,v 1.45 2006/12/12 18:40:18 alexkhansen Exp
$
-->
<title>Fink Documentation - Fink User's Guide</title></head><body>
<table width="100%" cellspacing="0">
@@ -1250,7 +1250,7 @@
There are some options, which apply to all fink commands. If you
type <tt style="white-space: nowrap;">fink --help</tt> you get the list of
options:
</p>
- <p>(as of <tt style="white-space: nowrap;">fink-0.24.6</tt>)</p>
+ <p>(as of <tt style="white-space: nowrap;">fink-0.26.0</tt>)</p>
<p><b>-h, --help</b> - displays help text.
</p>
<p><b>-q, --quiet</b> - causes <tt style="white-space:
nowrap;">fink</tt> to be less verbose, opposite of <b>--verbose</b>. Overrides
the <a href="#conf.optional">Verbose</a> flag in <tt style="white-space:
nowrap;">fink.conf</tt>.
@@ -1291,7 +1291,15 @@
<p><b>-m, --maintainer</b>
- (<tt style="white-space: nowrap;">fink-0.25</tt> and later)
Perform actions useful to package maintainers: run validation on
the <tt style="white-space: nowrap;">.info</tt> file before
building and on the <tt style="white-space: nowrap;">.deb</tt> after building a
- package; turn certain build-time warnings into fatal errors.</p>
+ package; turn certain build-time warnings into fatal errors; (<tt
style="white-space: nowrap;">fink-0.26</tt> and later) run the test suites as
specified in the field. This sets <b>--tests</b> and <b>--validate</b> to <tt
style="white-space: nowrap;">on</tt>.</p>
+ <p><b>--tests[=on|off|warn]</b> - (<tt style="white-space:
nowrap;">fink-0.26.0</tt> and later) Causes <tt style="white-space:
nowrap;">InfoTest</tt> fields to be activated and test suites specified
+ via <tt style="white-space: nowrap;">TestScript</tt> to be executed
(see the <a href="../packaging/packaging.en.html#reference.fields">Fink
Packaging Manual</a>). If no argument is given to this
+ option or if the argument is <tt style="white-space:
nowrap;">on</tt> then failures in test suites will
+ be considered fatal errors during builds. If the argument is <tt
style="white-space: nowrap;">warn</tt>
+ then failures will be treated as warnings.</p>
+ <p><b>--validate[=on|off|warn]</b> -
+ Causes packages to be validated during a build. If no argument is
+ given to this option or if the argument is <tt style="white-space:
nowrap;">on</tt> then validation failures will be considered fatal errors
during builds. If the argument is <tt style="white-space: nowrap;">warn</tt>
then failures will be treated as warnings.</p>
<p><b>-l, --log-output</b>
- Save a copy of the terminal output during each package building
process. By default, the file is stored in
@@ -1590,6 +1598,7 @@
This will let you change your mirror sites and proxy settings, among
others.
</p>
+ <p><b>New in</b> <tt style="white-space: nowrap;">fink-0.26.0</tt>: This
command will also let you turn on the unstable trees if desired.</p>
<h3><a name="usage.selfupdate">6.18 selfupdate</a></h3>
@@ -1651,9 +1660,9 @@
<h3><a name="usage.cleanup">6.24 cleanup</a></h3>
<p>
- Removes obsolete package files (.info, .patch, .deb) if newer versions are
available.
- This can reclaim large amounts of disk space. One or more modes must be
specified:</p>
-<pre>--debs - Delete .deb files (compiled binary package
archives)
+ Removes obsolete and temporary files.
+ This can reclaim large amounts of disk space. One or more modes may be
specified:</p>
+ <pre>--debs - Delete .deb files (compiled binary package
archives)
corresponding to versions of packages that are neither
described by a package description (.info) file in the
currently-active trees nor presently installed.
@@ -1662,9 +1671,13 @@
active trees.
--buildlocks, --bl - Delete stale buildlock packages.
--dpkg-status - Remove entries for packages that are not installed from
- the dpkg "status" database.</pre>
-<p>In addition, the following options may be used:</p>
-<pre>-k,--keep-src - Move old source files to /sw/src/old/ instead of
deleting them.
+ the dpkg "status" database.
+--obsolete-packages - Attempt to uninstall all installed packges that are
+ obsolete. (new in fink-0.26.0)
+--all - All of the above modes. (new in fink-0.26.0)</pre>
+ <p>If no mode is specified, <tt style="white-space: nowrap;">--debs
--sources</tt> is the default action. </p>
+ <p>In addition, the following options may be used:</p>
+ <pre>-k,--keep-src - Move old source files to /sw/src/old/
instead of deleting them.
-d,--dry-run - Print the names of the files that would be deleted, but
do not actually delete them.
-h,--help - Show the modes and options which are available.</pre>
@@ -1704,4 +1717,4 @@
provided the document and this copyright notice remain complete and
unmodified. Any commercial reproduction and any online publication
requires the explicit consent of the author.</p><hr>
-<p>Generated from <i>$Fink: uguide.en.xml,v 1.44 2006/09/23 23:52:44
alexkhansen Exp $</i></p></body></html>
+<p>Generated from <i>$Fink: uguide.en.xml,v 1.45 2006/12/12 18:40:18
alexkhansen Exp $</i></p></body></html>
Index: upgrade.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/users-guide/upgrade.en.php,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -d -r1.42 -r1.43
--- upgrade.en.php 24 Sep 2006 00:32:54 -0000 1.42
+++ upgrade.en.php 12 Dec 2006 18:52:38 -0000 1.43
@@ -1,7 +1,7 @@
<?
$title = "User's Guide - Upgrade";
$cvs_author = 'Author: alexkhansen';
-$cvs_date = 'Date: 2006/09/23 23:52:44';
+$cvs_date = 'Date: 2006/12/12 18:40:18';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="User\'s
Guide Contents"><link rel="next" href="conf.php?phpLang=en" title="The Fink
Configuration File"><link rel="prev" href="packages.php?phpLang=en"
title="Installing Packages">';
-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys - and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
Fink-commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/fink-commits
