Browse Source

There are here for now, though they may be moved one directory down later.

master
freesource 23 years ago
parent
commit
97ab23e30f
  1. 2036
      swim-doc/html/swim.sgml
  2. 354
      swim-doc/html/swimrc.sgml

2036
swim-doc/html/swim.sgml

File diff suppressed because it is too large

354
swim-doc/html/swimrc.sgml

@ -0,0 +1,354 @@
<!doctype debiandoc system>
<debiandoc>
<book>
<titlepag>
<title>swimrc - swim configuration file</title>
<author>
<name>Jonathan D. Rosenbaum</name>
<email>mttrader@access.mountain.net</email>
</author>
<version><date></version>
<copyright>
<copyrightsummary>
Copyright &copy; 1999 Jonathan D. Rosenbaum
</copyrightsummary>
<p>
SWIM, including this manual, is free software; you
may redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software
Foundation; either version 2, or (at your option) any later
version.
</p>
<p>
This is distributed in the hope that it will be useful, but
<em>without any warranty</em>; without even the implied
warranty of merchantability or fitness for a particular
purpose. See the GNU General Public License for more
details.
</p>
<p>
You should have received a copy of the GNU General Public
License with the <prgn>swim</prgn> source as the file
<tt>COPYING</tt>. If not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
</p>
</copyright>
</titlepag>
<toc sect>
<chapt id="description">DESCRIPTION
<p>
<prgn>swimrc</prgn> is the configuartion file for swim allowing many
default values to be set so that they do not have to be mentioned on the
command line. Swimrc interacts directly with Perl allowing a wide variety
of variables found in <prgn>SWIW::Conf</prgn> to be altered.
<chapt id="usage">USAGE
<p>
Values for variable can be altered for <STRONG>swim</STRONG> by assigning
different values enclosed in quotes or quoted whitespace (qw()), and ending
with a semi-colon.
<P>
<tt> $variable = ``value'';</tt>
<p>
<tt>$variable = ``(value1 value2 ..)'';</tt>
<P>
<P>
<chapt id="variables">VARIABLES
<p>
This is a list of variables with explanations. The default values for
<STRONG>swim</STRONG> are shown.
<sect>OUTPUT VARIABLE
<p>
<tt>$my_number</tt> can be changed to how many lines you would like
``swim -qf &lt;&gt;'' to print out, before the program asks for
<tt>-t</tt> or <tt>--total</tt>. Exception: If <tt>-i</tt> is
used in the query and there is more than one package then the total will
be presented.
<P>
Hint: <tt>-t</tt> can be used with all the various
<tt>--scripts</tt> family members to view the title of the script file
regardless of this variable setting, and if <tt>-t</tt> has to be
used, the titles will be displayed, which makes sense.
<P>
<strong>$my_number = 23;</strong>
<sect>HISTORY
<p>
This is a shell-like history kept in relation to searches and the most
recent edit when <tt>--stdin</tt> is used.
<P>
<strong>$HISTORY = 10;</strong>
<sect>AR or DPKG?
<p>
Debian packages are ar archives. If you are using a Debian Distribution
assign ``dpkg'' to $package_tool, otherwise assign ``ar'' to
$package_tool.
<p>
<STRONG>$package_tool = "/usr/bin/ar";</STRONG>
<sect>APT
<p>
<STRONG>Swim</STRONG> does not assign a value for apt. To use
<tt>--apt</tt> and <tt>-xyz</tt> assign <tt>$apt</tt> the
value ``yes''.
<P>
Example: <STRONG>$apt = "yes";</STRONG>
<sect>PAGER
<p>
<strong>less</strong> is a nice pager, unless you like
<strong>more</strong>! Pager is used for <tt>--help</tt> and
<STRONG>swim</STRONG> called without any options. There is an option
<tt>--nopager</tt> or <tt>-n</tt>. <strong>more</strong> comes from the
required package util-linux, whereas <strong>less</strong> comes from a
standard package called less. Values: ``less'', ``more'', or ``most''
or...
<P>
<STRONG>$ENV{PAGER} = "less";</STRONG>
<sect>NOT-INSTALLED VARIABLES
<p>
Assign values for <tt>$architecture</tt> and/or
<tt>$distribution</tt> to avoid having to use <tt>--arch</tt> and
<tt>--dists</tt> everytime the not-installed databases are accessed
with <tt>-n</tt> or made or altered.
<P>
Architectures are always being added so check with Debian to find a list.
There is <EM>alpha, arm, hurd-i386 (alternative kernel to linux), i386,
m68k, powerpc, sparc</EM>. Just use the arch found after the hyphen in the
Contents-(arch) file.
<P>
<STRONG>$architecture = "i386";</STRONG>
<P>
The distribution can be either <EM>stable, unstable, frozen, or
experimental (rare)</EM>. These represent the state of development that
the packages are under. The unstable distribution can have lot's of
changes within a very short time period, and frozen may or may not be
available.
<P>
<STRONG>$distribution = "unstable";</STRONG>
<P>
Distributions are divided into sections. These sections were called
distributions in the version 2.4.1.0 packaging manual, because they were
at
one time separate distributions, but this has since changed.
<P>
You can determine which of the sections <EM>main, non-free, contrib or
non-US</EM> to pull out of the Contents file if you don't want to use
<tt>--main</tt>, <tt>--contrib</tt>, <tt>--non-free</tt>, and
<tt>--non-us</tt> to selectively pick the sections.
<P>
For efficiency, you should choose the sections which you will be pulling
out of the Packages <tt>file(s)</tt> being targetted.
<P>
Rule: Use ``non-US'' not ``non-us''.
<p>
<STRONG>@user_defined_section = qw(main contrib non-free non-US);</STRONG>
<sect>DF LOCATION
<p>
A little philosophy: <STRONG>swim</STRONG> was developed for maximum
versatility, so whether you are just interested in researching, and
keeping tabs on the newest packages, or maintaining a Debian virtual
distribution on a non-Debian distribution, or you are a using
<STRONG>swim</STRONG> for distribution development, <STRONG>swim</STRONG>
provides a way.
<P>
The next two variables determine the location of the DF (default
directory/file system)
<P>
The default directory keeps track of Contents and/or Packages databases
retrieved with --ftp. The Contents and Packages databases and Release file
are give names specific to the distribution and architectures they
represent using the naming convention found in apt's sources directory.
You also have the freedom not to use the default directory, in which case
swim
will still do the renaming and keeping track of the mtime, but you will
have to remember where you put the files.
<P>
<STRONG>$default_directory = '/root/.swim';</STRONG>
<P>
The default root directory (DRD) is the key to easy management of binary
packages, source, dsc, and diff files received from --ftp, and provides an
easy way to put together a personalized distribution. This directory can
be
a real ftp site on your computer, or put wherever else you are allowed to
have directories. The DRD is always placed below the value assigned to
$default_directory. According to the previous assignment to
$default_directory, if the DRD is ``/pub/a/debian'' then the full path
would be ``/root/.swim/pub/a/debian''.
<P>
Example: When a package is downloaded it will be placed in
dists/distribution/section/architecture/subject below the DRD.
<P>
Rule: debian must be the final directory before dists, this is because
other distributions are placed alongside debian, like debian-non-US or
personal (specialized distribution).
<P>
<STRONG>$default_root_directory = '/pub/debian';</STRONG>
<P>
Because you may be using a real ftp site, this variable allows you to
determine what permissions <STRONG>swim</STRONG> will assign for
directories it
creates below the DRD.
<P>
<STRONG>$permission = '0755';</STRONG>
<sect>TEMPORARY DIRECTORY
<p>
If you want to set an alternative directory for the temporary files
created when the databases are made, change here. You may want to make
<tt>$tmp</tt> a RAM disk. See package loadlin for initrd documentation and
an explanation for making such a disk. There is also documentation in
/usr/src/kernel-source.version/Documentation. Whether this will speed
things up is a subject of experimentation.
<p>
<STRONG>$tmp = "/tmp";</STRONG>
<sect>FTP
<p>
You can alter the Firewall, Port, Timeout, Debug and Passive
characteristics of the ftp client as defined in Net::FTP(3pm) by providing
arguments to these variables. All variables but $timeout are set to untrue
by default.
<example>
$firewall = 0; (FTP firewall machine name)
$port = 0; (defaults to 23)
$timeout = 120; (120 seconds)
$debug = 0; (1 will turn on STDERR)
$passive = 0; (1 will enable)
</example>
<chapt id="othervars">OTHER VARIABLES
<p>
see SWIM::Conf
<chapt id="files">FILES
<p>
<tt> /etc/swim/swimrc</tt>
<p>
<tt>~/.swim/swimrc</tt>
<chapt>BUGS
<p>Send directly to mttrader@access.mountain.net.
</book>
</debiandoc>
Loading…
Cancel
Save