Blame view

README-alpha 2.62 KB
1
This is the GNU mailutils package.
Sergey Poznyakoff authored
2
This document describes the actions needed to build the pre-release
3
or Git version of the package. See end of file for copying conditions.
Sergey Poznyakoff authored
4 5

* Introduction
6

Sergey Poznyakoff authored
7
This is a *pre-release* version, and not ready for production use
8
yet. If you are taking source from Git, you will need to have several
9 10 11
special tools to help contribute. See the file README-hacking for more
information, See chapter `Building' for the detailed instructions on
how to build the package.
Sergey Poznyakoff authored
12

Sergey Poznyakoff authored
13
Please, note that the accompanying documentation may be inaccurate
14
or incomplete. The Git logs are the authoritative documentation of
Sergey Poznyakoff authored
15
all recent changes.
16 17 18

Report bugs to <bug-mailutils@gnu.org>

Sergey Poznyakoff authored
19
* Checking Out the Sources
20

Sergey Poznyakoff authored
21
The following instructions apply if you wish to obtain sources from
22
the Git repository:
23

24
To clone the source tree from the repository, issue the following command:
25

26
  git clone git://git.savannah.gnu.org/mailutils.git
27

Sergey Poznyakoff authored
28
This will give you read-only access.  If you think you need write access,
29 30
contact the mailing list.

Sergey Poznyakoff authored
31 32
* Building

33 34 35 36 37 38 39
Usual procedures apply:

 ./configure
 make
 make install

See INSTALL and README for the detailed instructions.
Sergey Poznyakoff authored
40 41 42

* Debugging

Sergey Poznyakoff authored
43
To enable additional debugging information, configure the package
Sergey Poznyakoff authored
44
with --enable-debug option.
Sergey Poznyakoff authored
45

Sergey Poznyakoff authored
46 47
Unless you compile mailutils statically, you will need to run
following command to debug any utility: 
Sergey Poznyakoff authored
48 49 50

  libtool --mode execute gdb UTILITY-NAME

Sergey Poznyakoff authored
51
Sometimes it is impossible or inconvenient to start a utility from
Sergey Poznyakoff authored
52 53 54 55
the debugger. In this case, use --HANG option, which is supported by
any of the mailutils programs. The option instructs the program to
sleep for a given number of seconds (3600 by default) right after
startup. For example, to debug `mimeview' utility, run
Sergey Poznyakoff authored
56

57
  mimeview --HANG [OTHER-OPTIONS]
Sergey Poznyakoff authored
58

Sergey Poznyakoff authored
59 60
Then switch to another terminal, get the PID of the ivoked utility and
attach to it using gdb: 
Sergey Poznyakoff authored
61 62 63 64 65 66 67 68 69 70 71

	gdb mimeview PID

Once in gdb, issue the following command

	set _argp_hang=0

Now set your breakpoints and proceed as usual.

* Copyright information:

72
Copyright (C) 2002, 2003, 2004, 2005, 2007, 2008 Free Software Foundation, Inc.
Sergey Poznyakoff authored
73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89

   Permission is granted to anyone to make or distribute verbatim copies
   of this document as received, in any medium, provided that the
   copyright notice and this permission notice are preserved,
   thus giving the recipient permission to redistribute in turn.

   Permission is granted to distribute modified versions
   of this document, or of portions of it,
   under the above conditions, provided also that they
   carry prominent notices stating who last changed them.


Local Variables:
mode: outline
paragraph-separate: "[ 	]*$"
version-control: never
End:
90

91