~ubuntu-branches/ubuntu/utopic/xarchiver/utopic

« back to all changes in this revision

Viewing changes to INSTALL

  • Committer: Package Import Robot
  • Author(s): Markus Koschany
  • Date: 2014-05-20 11:30:18 UTC
  • mfrom: (1.1.10)
  • Revision ID: package-import@ubuntu.com-20140520113018-ybro6c5fp38x22kt
Tags: 1:0.5.3+dfsg-1
* Imported Upstream version 0.5.3+dfsg. (Closes: #748541)
  - New features:
    + RAR5 support.
    + Full Test/Verify support.
* Drop the following patches. They were merged or fixed upstream.
  - check-for-password-protected-files-on-double-click.patch
  - fix-7z-crash.patch
  - fix-multiextract.patch
  - fix-segfault-non-existent-archive-cmdl-switch-x.patch
  - new-homepage.patch
  - no-donators-menu.patch
  - xz-support.patch
* New patches:
  - open-url.patch: Add support for opening file:// URLs. Thanks to Frederick
    Guerin.
  - disable-donate.patch: Fix GLib-GObject-Warning on startup.
  - fix-rename-and-delete-segfault.patch: Fix a segmentation fault that
    occured when files in tar.xz or tar.bz2 archives were renamed or deleted.
* Add Forwarded headers to all patches.
* debian/control:
  - Remove unrar-free from Suggests. It is RC-buggy and incapable to work with
    modern RAR formats.
* debian/rules:
  - Remove override for dh_auto_clean.
* Drop xarchiver.docs. Do not install TODO anymore. It contains nothing
  noteworthy.
* Add README.source.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Installation Instructions
2
2
*************************
3
3
 
4
 
Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005,
5
 
2006, 2007 Free Software Foundation, Inc.
 
4
Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005 Free
 
5
Software Foundation, Inc.
6
6
 
7
7
This file is free documentation; the Free Software Foundation gives
8
8
unlimited permission to copy, distribute and modify it.
10
10
Basic Installation
11
11
==================
12
12
 
13
 
Briefly, the shell commands `./configure; make; make install' should
14
 
configure, build, and install this package.  The following
15
 
more-detailed instructions are generic; see the `README' file for
16
 
instructions specific to this package.
 
13
These are generic installation instructions.
17
14
 
18
15
   The `configure' shell script attempts to guess correct values for
19
16
various system-dependent variables used during compilation.  It uses
26
23
 
27
24
   It can also use an optional file (typically called `config.cache'
28
25
and enabled with `--cache-file=config.cache' or simply `-C') that saves
29
 
the results of its tests to speed up reconfiguring.  Caching is
 
26
the results of its tests to speed up reconfiguring.  (Caching is
30
27
disabled by default to prevent problems with accidental use of stale
31
 
cache files.
 
28
cache files.)
32
29
 
33
30
   If you need to do unusual things to compile the package, please try
34
31
to figure out how `configure' could check whether to do them, and mail
38
35
may remove or edit it.
39
36
 
40
37
   The file `configure.ac' (or `configure.in') is used to create
41
 
`configure' by a program called `autoconf'.  You need `configure.ac' if
42
 
you want to change it or regenerate `configure' using a newer version
43
 
of `autoconf'.
 
38
`configure' by a program called `autoconf'.  You only need
 
39
`configure.ac' if you want to change it or regenerate `configure' using
 
40
a newer version of `autoconf'.
44
41
 
45
42
The simplest way to compile this package is:
46
43
 
47
44
  1. `cd' to the directory containing the package's source code and type
48
 
     `./configure' to configure the package for your system.
 
45
     `./configure' to configure the package for your system.  If you're
 
46
     using `csh' on an old version of System V, you might need to type
 
47
     `sh ./configure' instead to prevent `csh' from trying to execute
 
48
     `configure' itself.
49
49
 
50
 
     Running `configure' might take a while.  While running, it prints
51
 
     some messages telling which features it is checking for.
 
50
     Running `configure' takes awhile.  While running, it prints some
 
51
     messages telling which features it is checking for.
52
52
 
53
53
  2. Type `make' to compile the package.
54
54
 
67
67
     all sorts of other programs in order to regenerate files that came
68
68
     with the distribution.
69
69
 
70
 
  6. Often, you can also type `make uninstall' to remove the installed
71
 
     files again.
72
 
 
73
70
Compilers and Options
74
71
=====================
75
72
 
81
78
by setting variables in the command line or in the environment.  Here
82
79
is an example:
83
80
 
84
 
     ./configure CC=c99 CFLAGS=-g LIBS=-lposix
 
81
     ./configure CC=c89 CFLAGS=-O2 LIBS=-lposix
85
82
 
86
83
   *Note Defining Variables::, for more details.
87
84
 
90
87
 
91
88
You can compile the package for more than one kind of computer at the
92
89
same time, by placing the object files for each architecture in their
93
 
own directory.  To do this, you can use GNU `make'.  `cd' to the
 
90
own directory.  To do this, you must use a version of `make' that
 
91
supports the `VPATH' variable, such as GNU `make'.  `cd' to the
94
92
directory where you want the object files and executables to go and run
95
93
the `configure' script.  `configure' automatically checks for the
96
94
source code in the directory that `configure' is in and in `..'.
97
95
 
98
 
   With a non-GNU `make', it is safer to compile the package for one
99
 
architecture at a time in the source code directory.  After you have
100
 
installed the package for one architecture, use `make distclean' before
101
 
reconfiguring for another architecture.
 
96
   If you have to use a `make' that does not support the `VPATH'
 
97
variable, you have to compile the package for one architecture at a
 
98
time in the source code directory.  After you have installed the
 
99
package for one architecture, use `make distclean' before reconfiguring
 
100
for another architecture.
102
101
 
103
102
Installation Names
104
103
==================
191
190
     ./configure CC=/usr/local2/bin/gcc
192
191
 
193
192
causes the specified `gcc' to be used as the C compiler (unless it is
194
 
overridden in the site shell script).
195
 
 
196
 
Unfortunately, this technique does not work for `CONFIG_SHELL' due to
197
 
an Autoconf bug.  Until the bug is fixed you can use this workaround:
198
 
 
199
 
     CONFIG_SHELL=/bin/bash /bin/bash ./configure CONFIG_SHELL=/bin/bash
 
193
overridden in the site shell script).  Here is a another example:
 
194
 
 
195
     /bin/bash ./configure CONFIG_SHELL=/bin/bash
 
196
 
 
197
Here the `CONFIG_SHELL=/bin/bash' operand causes subsequent
 
198
configuration-related scripts to be executed by `/bin/bash'.
200
199
 
201
200
`configure' Invocation
202
201
======================