aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 47c20526bf7aca58a408ebc6ae59512110ad3814 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
Copyright (C) 2003 Jason Woodward <woodwardj at jaos dot org>

This program is free software; you can 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 of the License, or
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Library General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.



Table of Contents:
 1. Features
 2. Requirements
 3. Installation
 4. slapt-getrc
 5. Troubleshooting
 6. Thanks and contributions



 1. Features

    slapt-get tries to emulate Debian's apt-get as closely as possible.

    * cache package data and update data from mirror site
    * show packages that are available (from cached data)
    * allow packages to be retrieved and installed by name
    * allow updates to be retrieved and applied (frontent to updatepkg)
    * show description of packages
    * list installed packages
    * remove packages (frontent to removepkg)
    * dist-upgrade from one slackware release to another
    * exclude (hold) packages from upgrades



 2. Requirements

    slapt-get requires glibc-2.3.1 (slackware9 or better) due to 
    the regex.h updates. 

    The following packages are required to build slapt-get:
    make, gcc, curl, glibc, kernel-headers, binutils, zlib, and openssl



 3. Installation

    See INSTALL.



 4. slapt-getrc

    The slapt-getrc file consists currently of the following keys:
     MIRROR
     WORKINGDIR
     EXCLUDE

    Choose mirror from slackware.com mirror list:
    lynx -source http://www.slackware.com/getslack/|grep -i href \
     |awk -F "HREF=" '{print $2}'|cut -f2 -d'"'

    The MIRROR must be a path to a valid slackware release directory.

    WORKINGDIR will hold the package data and downloaded packages.

    EXCLUDE is a comma seperated list of pkgs you want excluded from
    updating.



 5. Troubleshooting

   Probably lots of bugs.  email bug reports to me:
    Jason Woodward <woodwardj at jaos dot org>

   Make sure --update is ran once initially and downloaded *_list files are
   good.

   Some mirrors are incomplete and the downloaded file is actually html
   specifying the webservers error message.  MD5 checking has been 
   incorporated in order to alleviate this problem.

   If you are getting segfaults, add -g to CFLAGS in the Makefile, change the
   DEBUG define in src/main.h to 1, and rebuild ( make clean && make ).  Run
   in gdb and let me know via email where the fault happens.

   See the FAQ for more info.

 6. Thanks and contributions

   Big thanks to Dan Barber <danb at mojolin dot com> for his insight and help
   with documentation suggestions and feature requests.

   Thanks to James Simmons over at linuxpackages.net for his interest, support,
   and ideas.