Discussion:
[Fink-i18n] [Fwd: [cvs] web/xml/users-guide uguide.en.xml, 1.51, 1.52]
Alexander Hansen
2009-03-01 02:17:38 UTC
Permalink
We'll get back into the habit of forwarding the diffs on to fink-i18n

Index: uguide.en.xml
===================================================================
RCS file: /cvsroot/fink/web/xml/users-guide/uguide.en.xml,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -d -r1.51 -r1.52
--- uguide.en.xml 27 Jun 2008 00:55:00 -0000 1.51
+++ uguide.en.xml 1 Mar 2009 01:50:36 -0000 1.52
@@ -43,7 +43,7 @@
<ul>
<li>
<p>
-An installed Mac OS X system, version 10.2 or later, or equivalent
+An installed Mac OS X system, version 10.4 or later, or equivalent
Darwin releases.
Earlier versions of both will <em>not</em> work.
See below for more information about supported systems.
@@ -65,13 +65,12 @@
<li>
<p>
Developer tools.
-On Mac OS X, install the Developer.pkg package from the Developer
-Tools (known as XCode for 10.3 and 10.4) CD (they're on the main DVD
for OS 10.4), or <link url="http://connect.apple.com">download</link>
the latest version--this is often desirable, as later versions
frequently fix issues (though admittedly sometimes they break things).
+On Mac OS X, install the XcodeTools.mpkg package from the installation DVD,
+or <link url="http://connect.apple.com">download</link> the latest
version--this is often desirable, as later versions frequently fix
issues (though admittedly sometimes they break things).
Note that the tools must match your Mac OS X version.
-On Darwin, the tools should be present in the default install.
</p>
<p>
-It's a good idea to have the Developer Tools installed even if you
+It's a good idea to have XCode installed even if you
don't intend to build packages from source.
Some of the programs installed by the package are actually general
purpose command line tools.
@@ -89,23 +88,9 @@
</section>
<section name="supported-os">
<title>Supported Systems</title>
- <p><em>Mac OS X 10.4</em> is the leading-edge platform, and is
considered to be <quote>fully supported and tested</quote>, though as a
newer operating system there are still some issues. Most of the
developers run it, and those who are running 10.3 have 10.4 users test
their work. Note, however, that
-fink on intel hardware is still considered to be of <em>beta</em>
quality.</p>
- <p>
- <em>Mac OS X 10.3</em> is considered to be <quote>fully
supported and tested</quote>, although there may still be stray compile
problems with single packages. Many of the developers run it, and those
who don't have 10.3 users test their work.
-</p>
- <p><em>Mac OS X 10.2</em> is still supported to some extent.
Fink 0.6.4 is the last distribution to suppport this OS.</p>
- <p>
- <em>Mac OS X 10.1</em> is still supported to some extent.
-You must run Fink 0.4.1 and no later versions.
-</p>
+ <p><em>Mac OS X 10.5</em> is the leading-edge platform, and is
considered to be <quote>fully supported and tested</quote>, though as a
newer operating system there are still some issues. Most of the
developers run it, and those who are running 10.4 have 10.5 users test
their work.</p>
<p>
-<em>Darwin 8.x</em> is the Darwin version corresponding to Mac OS X
10.4, <em>Darwin 7.x</em> is the Darwin version corresponding to Mac OS
X 10.3, and <em>Darwin 6.x</em> is the Darwin version corresponding to
Mac OS X
-10.2.
-They should work in general, but are not as well tested as most people
-just run Mac OS X proper instead.
-You may run into problems with packages that use features specific to
-Mac OS X - affected packages include XFree86 and possibly esound.
+ <em>Mac OS X 10.4</em> is considered to be <quote>fully
supported and tested</quote>, although there may still be stray compile
problems with single packages. Many of the developers run it, and those
who don't have 10.4 users test their work.
</p>
</section>
<section name="src-vs-bin">
@@ -159,7 +144,7 @@
After that you must set up your shell environment to use the software
installed by Fink.
You only need to do this once; you can upgrade any Fink installation
-(starting with release 0.2.0) in place, without reinstalling.
+in place, without reinstalling.
This is covered in the <xref chapter="upgrade">Upgrading
chapter</xref>.
</p>
@@ -179,7 +164,7 @@
<link url="http://www.finkproject.org/download/bindist.php">download
page</link>
(you may have to use your browser's "Save Target as..." or "Download
to Disk" function), double-click it to mount it.
-Open the "Fink 0.x.x Installer" disk icon that appears on your desktop
(or wherever you downloaded it) after Disk Utility (Disk Copy for OS
versions prior to 10.3) has verified the file.
+Open the "Fink 0.x.x Installer" disk icon that appears on your desktop
(or wherever you downloaded it) after Disk Utility has verified the file.
Inside you'll find some documentation and an installer package.
Double-click the installer package and follow the instructions on
screen.
@@ -405,10 +390,10 @@
<p>
<em>Note:</em>
<code>dselect</code> has known difficulties with the Mac OS X
Terminal application. You should run the following commands before
using it, or put them in the appropriate startup file (e.g.
<code>.cshrc</code> / <code>.profile</code>):</p>
- <p>tcsh users:</p>
- <codeblock>setenv TERM xterm-color</codeblock>
<p>bash users:</p>
<codeblock>export TERM=xterm-color</codeblock>
+ <p>tcsh users:</p>
+ <codeblock>setenv TERM xterm-color</codeblock>
<p>
The main menu has several choices:
</p>
@@ -562,7 +547,7 @@
<link url="http://www.finkproject.org/faq/">FAQ</link>.
</p>
<p>
-For <code>fink</code> versions since 0.23.0 you can tell it to try to
download
+You can tell <code>fink</code> to try to download
pre-compiled binary packages, if available, instead of building them.
Just pass
the <xref chapter="usage" section="options">--use-binary-dist (or -b)
option</xref> to <code>fink</code>. This can save you a lot of time. E.g.
@@ -592,43 +577,29 @@
<p>When you want to install a package, you should first check the
<link url="http://pdb.finkproject.org/pdb/index.php">package
database</link> and see if it is available at all through Fink. The
available version(s) of the package will be shown in several rows of a
table. These are:</p>
<ul>
<li>Binary Distribution
-<ol>
- <li><p>
- <em>0.4.1:</em> this is the version that can be installed
from binaries for OS 10.1.</p></li>
- <li><p><em>0.6.4:</em> this is the version that can be
installed from binaries for OS 10.2.</p></li>
- <li><p><em>0.7.2</em>
- This is the base version that can be installed from binaries for OS
10.3. If you <xref chapter="install" section="bin">update</xref> Fink,
later versions of some packages may be available.</p>
- </li>
- <li><p><em>&fink_version;:</em> This is the base version
that can be installed from binaries for OS 10.5. If you <xref
chapter="install" section="bin">update</xref> Fink, later versions of
some packages may be available.
-</p></li>
- </ol>
-
- </li>
- </ul>
- <ul>
+ <ol>
+ <li><p><em>0.8.1:</em> This is the base version that can
be installed from binaries for OS 10.4. If you <xref chapter="install"
section="bin">update</xref> Fink, later versions of some packages may be
available.</p></li>
+ <li><p><em>&fink_version;:</em> This is the base version
that can be installed from binaries for OS 10.5. If you <xref
chapter="install" section="bin">update</xref> Fink, later versions of
some packages may be available.</p></li>
+ </ol></li>
<li>CVS/rsync Distributions
-<ol>
- <li>
- <p>
- <em>10.2-gcc3.3 stable:</em> This is the most recent
stable version that can be installed from the stable source tree for OS
10.2 with the <code>gcc 3.3</code> update to the Developer Tools. To be
able to install this version, you may need to enable <link
url="http://www.finkproject.org/doc/cvsaccess/index.php">CVS</link> or
rsync access. If you have not applied the <code>gcc 3.3</code> update
you may not see this version (or possibly even the package).</p>
- <p>Note: Unlike the case for some other projects, Fink
distributes the most recent stable versions of packages via CVS, as well
as versions in need of testing (see the section on unstable below).
Enabling CVS or rsync updating gives you access to new stable versions
of packages before the binary distribution is updated.
-</p>
- </li>
- <li><p><em>10.3 stable:</em> This is the most recent
version that can be installed from the stable source tree for OS
10.3.</p></li>
+ <ol>
<li><p><em>10.4/powerpc stable:</em> This is the most
recent version that can be installed from the stable source tree for OS
10.4 users
on PowerPC hardware.</p></li>
<li><p><em>10.4/intel stable:</em> This is the most recent
version that can be installed from the stable source tree for OS 10.4 users
on intel hardware.</p></li>
- <li>
- <p>
- <em>10.2-gcc3.3 unstable:</em> This is the latest version
that can be installed from the unstable source tree for OS 10.2 with
<code>gcc 3.3</code>. To install this version, follow the <link
url="http://www.finkproject.org/faq/usage-fink.php#unstable">instructions</link>
on how to install unstable packages.</p>
- <p>Note: <em>unstable</em> doesn't necessarily mean
<em>unusable</em>, but install such packages at your own risk.
-</p>
- </li>
- <li><p><em>10.3 unstable:</em> This is the latest version
that can be installed from the unstable source tree for OS 10.3.</p></li>
<li><p><em>10.4/powerpc unstable:</em> This is the most
recent version that can be installed from the unstable source tree for
OS 10.4 users
on PowerPC hardware.</p></li>
<li><p><em>10.4/intel unstable:</em> This is the most
recent version that can be installed from the unstable source tree for
OS 10.4 users
+on intel hardware.</p>
+ <p>Note: <em>unstable</em> doesn't necessarily mean
<em>unusable</em>, but install such packages at your own risk.</p>
+</li>
+ <li><p><em>10.5/powerpc stable:</em> This is the most
recent version that can be installed from the stable source tree for OS
10.4 users
+on PowerPC hardware.</p></li>
+ <li><p><em>10.5/intel stable:</em> This is the most recent
version that can be installed from the stable source tree for OS 10.4 users
+on intel hardware.</p></li>
+ <li><p><em>10.5/powerpc unstable:</em> This is the most
recent version that can be installed from the unstable source tree for
OS 10.4 users
+on PowerPC hardware.</p></li>
+ <li><p><em>10.5/intel unstable:</em> This is the most
recent version that can be installed from the unstable source tree for
OS 10.4 users
on intel hardware.</p></li>
</ol></li>
</ul>
@@ -647,35 +618,18 @@
<li>
<p>
<em>xfree86, xfree86-shlibs:</em>
-Install both of these packages for XFree86 4.3.0 (OS 10.2 only), 4.4.0
(10.2 or 10.3), or 4.5.0 (10.3 or 10.4).
+Install both of these packages for XFree86-4.5.0 (OS 10.4 only).
</p>
</li>
- <li><p><em>xorg, xorg-shlibs</em>(10.3 or 10.4) Install these
packages to get the 6.8.2 release of the X.org X11 distribution.</p></li>
+ <li><p><em>xorg, xorg-shlibs</em> (OS 10.4 only ) Install
these packages to get the 6.8.2 release of the X.org X11
distribution.</p></li>
<li>
<p>
<em>system-xfree86 + -shlibs, -dev:</em>
-These packages are automatically generated (for Fink 0.6.2 or later) if
you install Apple's X11, or manually installed XFree86 or X.org.
+These packages are automatically generated if you install Apple's X11,
or manually installed XFree86 or X.org.
They will then act as
dependency placeholders.
</p>
</li>
- <li>
- <p>
- <em>xfree86-base, xfree86-rootless [-threaded] + -shlibs,
-dev</em>
-(10.1 or 10.2 only) These packages install all of XFree86 4.2.1.1
(4.2.0 on 10.1). The <code>-threaded</code> variant was provided for
applications that required it, and this functionality is standard in
later XFree86 versions. The <code>-rootless</code> packages include the
XDarwin display server--the name is historical.
-</p><p>You must install all six packages to build X11-based packages
from source.
-</p>
- </li>
- <!-- OBSOLETE <li>
- <p>
-system-xtools:
-Install this package if you have Tenon's Xtools product installed.
-Like system-xfree86, this will just do a sanity check and leave the
-actual files alone.
-</p>
- </li>
-
--->
</ul>
<p>
For more information on installing and running X11, refer to the
@@ -713,8 +667,7 @@ </p> <p>For Fink Commander, select Binary-&gt;Update descriptions to
update the package list, and then Binary-&gt;Dist-Upgrade packages to
update to new versions.</p>
<p>
-For more information, especially about upgrading from Fink versions
-older than 0.3.0, see the
+For more information, see the
<link url="http://www.finkproject.org/download/upgrade.php">Upgrade
Matrix</link>.
</p>
</section>
@@ -728,12 +681,12 @@
packages; the actual source code is downloaded as needed.
</p>
<p>
-If you have Fink 0.2.5 or later, the first step can be accomplished by
+The first step can be accomplished by
running <code>fink selfupdate</code>.
That command will check with the Fink website to see if a new point
release is available, and will automatically download and install the
package descriptions in that case.
-In recent versions of the <code>fink</code> command, you get the
+You also have the
option to pull package descriptions directly from CVS or via rsync.
CVS is a version-controlled repository where the package descriptions
are stored and managed.
@@ -743,17 +696,6 @@
<link url="http://www.finkproject.org/download/fix-upgrade.php">these
special instructions</link>.)</p>
<p>
-If you have a version of Fink older than 0.2.5, you must download the
-package descriptions manually.
-Visit the <link
url="http://sourceforge.net/project/showfiles.php?group_id=17203">download
-area</link> and look for the latest packages-0.x.x.tar.gz tarball in
-the "distribution" module.
-Download it, then install it as follows:
-</p>
- <codeblock>tar -xzf packages-0.x.x.tar.gz
-cd packages-0.x.x
-./inject.pl</codeblock>
- <p>
Once you have updated your package descriptions (no matter which way),
you should update all packages at once with the command <code>fink
update-all</code>.
@@ -773,7 +715,7 @@
packages.
</p>
<p>
-Starting with fink 0.23.0 using the UseBinaryDist option (settable via the
+You may use the UseBinaryDist option (settable via the
<xref chapter="usage" section="options">--use-binary-dist (or -b)
option</xref>
or in the <xref chapter="conf">Fink configuration file</xref>) both
source and
binary descriptions will be updated if you call <code>fink
selfupdate</code>.
@@ -880,16 +822,14 @@
<p>
You may also add your own trees in <code>/sw/fink/dists</code> for your
own purposes, but this is not necessary in most
circumstances. The default trees are "local/main local/bootstrap
-stable/main". This list should be kept in sync with the
-<code>/sw/etc/apt/sources.list</code> file. (As of fink 0.21.0,
<code>fink</code>
-does this for you automatically.)
-</p><p>The order of the trees is meaningful, as packages from later
trees in the list may
+stable/main". This list is automatically kept in sync with the
+<code>/sw/etc/apt/sources.list</code> file.</p><p>The order of the
trees is meaningful, as packages from later trees in the list may
override packages from earlier ones.</p>
-</li>
<li>
<p>
- <em>Distribution:</em> 10.1, 10.2-gcc3.3, 10.3, or 10.4</p>
- <p>Fink needs to know which version of Mac OS X you are
+ <em>Distribution:</em> 10.4</p>
+<!-- I'm not sure how much of the following paragraph should be
rewritten to reflect current supported versions--> <p>Fink
needs to know which version of Mac OS X you are
running. Mac OS X 10.0 and earlier are not supported, and 10.1 and 10.2
are no
longer supported by current versions of <code>fink</code>. Mac OS X
10.2 users are
restricted to fink-0.24.7, released in June 2005. This
@@ -1049,7 +989,6 @@
but only operates on that single <code>fink</code> invocation. Passing
<code>fink</code> the
<code>--no-use-binary-dist</code> flag overrides this, and
compiles from source
for that single <code>fink</code> invocation.
-<em>Only available as of fink version 0.23.0</em>.
</p><p>Note that this mode instructs <code>fink</code> to
download an available binary
if that version is the latest available version of the
package; it does <em>not</em> cause <code>fink</code>
to choose a version based on its binary availability.
@@ -1192,7 +1131,7 @@
</section>
<section name="sourceslist">
<title>Managing apt's sources.list file</title>
- <p>Starting with fink 0.21.0, fink actively manages the file
+ <p>Fink actively manages the file
<code>/sw/etc/apt/sources.list</code> which is used by apt to locate
binary files for installation. The default sources.list file looks
something like this, adjusted to match your Distribution and Trees:
@@ -1230,10 +1169,6 @@
modifications to the top of the file (above the first default line) and
the bottom of the file (below the last default line).
</p>
- <p>
-Note: If you had modified <code>/sw/etc/apt/sources.list</code> prior
to upgrading
-to fink 0.21.0, you will find your former file stored at
<code>/sw/etc/apt/sources.list.finkbak</code> .
-</p>
</section>
</chapter>
<chapter filename="usage">
@@ -1689,9 +1624,6 @@
<section name="dumpinfo">
<title>dumpinfo</title>
<p>
-Only available in <code>fink</code> newer than version 0.21.0
- </p>
- <p>
Shows how <code>fink</code> parses parts of a package's
<filename>.info</filename> file. Various
fields and percent expansions will be displayed according
to <em>options</em> as follows:
@@ -1709,25 +1641,8 @@
</section>
<section name="show-deps">
<title>show-deps</title>
- <p>Only available in fink-0.23-6 and later.</p>
<p>Displays a human-readable list of the compile-time (build) and
run-
time (installation) dependencies of the listed package(s).</p>
</section>
- <!-- 'fink snapshot' will not be included in 0.24
- <section name="snapshot">
- <title>snapshot</title>
- <p>
- Only available in <code>fink</code> newer than version 0.24
- </p>
- <p>
- Creates a new .info file for you in /tmp which describes all
- of the current packages you have installed. If you copy that
- .info file to another computer with Fink installed and build
- it, you can closely replicate your Fink environment.
- Documentation for how to use the snapshot is included in the
- created .info file itself.
- </p>
- </section>
--->
</chapter>
</document>

Loading...