Commit 241c78af 241c78af83d5ffda185cc00f0561bc79a918789f by Alain Magloire

README-alpha : Tell them to run autogen.sh, the last person trying

to configure from CVS wasted his time and mine.

doc/auth.texi doc/body.texi doc/headers.texi doc/mailbox.texi doc/message.texi
doc/sfrom.c.texi doc/stream.texi : Very shy tentative to get some docs.
1 parent 4290bdcd
1 This is the GNU mailutils package. 1 This is the GNU mailutils package.
2 2
3 This is a *pre-release* version, and not ready for production use yet. If you 3 This is a *pre-release* version, and not ready for production use yet. If you
4 are taking source from CVS, you will need to have libtool, automake, and autoconf 4 are taking source from CVS, you will need to have libtool, automake, and
5 installed to help contribute. See the file 'INSTALL' for (generic) installation 5 autoconf installed to help contribute. The script autogen.sh is provided to
6 instructions. 6 help autoconfigure mailutils from the cvs src. See the file 'INSTALL' for
7 (generic) installation instructions.
7 8
8 Report bugs to <bug-mailutils@gnu.org> 9 Report bugs to <bug-mailutils@gnu.org>
9 10
......
...@@ -12,21 +12,12 @@ if not set, this function can be override by a custom method. ...@@ -12,21 +12,12 @@ if not set, this function can be override by a custom method.
12 @deftypefun int auth_prologue (auth_t @var{auth}) 12 @deftypefun int auth_prologue (auth_t @var{auth})
13 @end deftypefun 13 @end deftypefun
14 14
15 @deftypefun int auth_set_prologue (auth_t @var{auth}, int (*@var{_prologue})(auth_t), void *@var{owner})
16 @end deftypefun
17
18 @deftypefun int auth_authenticate (auth_t @var{auth}, char **@var{user}, char **@var{passwd}) 15 @deftypefun int auth_authenticate (auth_t @var{auth}, char **@var{user}, char **@var{passwd})
19 @end deftypefun 16 @end deftypefun
20 17
21 @deftypefun int auth_set_authenticate (auth_t auth, int (*@var{_authenticate}) (auth_t, char **, char **), void *@var{owner})
22 @end deftypefun
23
24 @deftypefun int auth_epilogue (auth_t @var{auth}) 18 @deftypefun int auth_epilogue (auth_t @var{auth})
25 @end deftypefun 19 @end deftypefun
26 20
27 @deftypefun int auth_set_epilogue (auth_t @var{auth}, int (*@var{_epilogue})(auth_t), void *@var{owner})
28 @end deftypefun
29
30 A simple example of an authenticate function: 21 A simple example of an authenticate function:
31 @example 22 @example
32 #include <mailutils/auth.h> 23 #include <mailutils/auth.h>
......
...@@ -23,11 +23,5 @@ The resources allocate are release. ...@@ -23,11 +23,5 @@ The resources allocate are release.
23 @deftypefun int body_size (body_t @var{body}, size_t*@var{psize}) 23 @deftypefun int body_size (body_t @var{body}, size_t*@var{psize})
24 @end deftypefun 24 @end deftypefun
25 25
26 @deftypefun int body_set_size (body_t @var{body}, int (*@var{_size})(body_t, size_t*), void *@var{owner})
27 @end deftypefun
28
29 @deftypefun int body_lines (body_t @var{body}, size_t *@var{plines}) 26 @deftypefun int body_lines (body_t @var{body}, size_t *@var{plines})
30 @end deftypefun 27 @end deftypefun
31
32 @deftypefun int body_set_lines (body_t @var{body}, int (*@var{_lines})(body_t, size_t*), void *@var{owner})
33 @end deftypefun
......
...@@ -77,9 +77,6 @@ Value of field-name @var{fn} is returned in buffer @var{fv} of size @var{len}. ...@@ -77,9 +77,6 @@ Value of field-name @var{fn} is returned in buffer @var{fv} of size @var{len}.
77 The number of bytes written is put in @var{n}. 77 The number of bytes written is put in @var{n}.
78 @end deftypefun 78 @end deftypefun
79 79
80 @deftypefun int header_set_get_value (header_t @var{hdr}, int (*@var{_get_value}) (header_t, const char *, char *, size_t, size_t *), void *@var{owner})
81 @end deftypefun
82
83 @deftypefun int header_get_stream (header_t @var{hdr}, stream_t *@var{pstream}) 80 @deftypefun int header_get_stream (header_t @var{hdr}, stream_t *@var{pstream})
84 @end deftypefun 81 @end deftypefun
85 82
......
...@@ -53,15 +53,9 @@ Return non-zero value if message is multi-part. ...@@ -53,15 +53,9 @@ Return non-zero value if message is multi-part.
53 @deftypefun int message_get_num_parts (message_t @var{msg}, size_t *nparts) 53 @deftypefun int message_get_num_parts (message_t @var{msg}, size_t *nparts)
54 @end deftypefun 54 @end deftypefun
55 55
56 @deftypefun int message_set_get_num_parts (message_t @var{msg}, size_t *nparts)
57 @end deftypefun
58
59 @deftypefun int message_get_part (message_t @var{msg}, size_t part, message_t *msg) 56 @deftypefun int message_get_part (message_t @var{msg}, size_t part, message_t *msg)
60 @end deftypefun 57 @end deftypefun
61 58
62 @deftypefun int message_set_get_part ((message_t @var{msg}, size_t part, message_t *msg)
63 @end deftypefun
64
65 @deftypefun int message_add_part (message_t @var{msg}, message_t @var{msg}) 59 @deftypefun int message_add_part (message_t @var{msg}, message_t @var{msg})
66 @end deftypefun 60 @end deftypefun
67 61
......
...@@ -18,6 +18,14 @@ main (int argc, const char **argv) ...@@ -18,6 +18,14 @@ main (int argc, const char **argv)
18 18
19 mail = (argc == 2) ? argv[1] : getenv ("MAIL"); 19 mail = (argc == 2) ? argv[1] : getenv ("MAIL");
20 20
21 /* Register the type of mailbox. IMAP4, POP3 and local format */
22 @{
23 list_t registrar;
24 registrar_get_list (&registrar);
25 list_append (registrar, imap_record);
26 list_append (registrar, path_record);
27 list_append (registrar, pop_record);
28 @}
21 status = mailbox_create (&mbox, mail, 0); 29 status = mailbox_create (&mbox, mail, 0);
22 if (status != 0) 30 if (status != 0)
23 @{ 31 @{
...@@ -32,12 +40,7 @@ main (int argc, const char **argv) ...@@ -32,12 +40,7 @@ main (int argc, const char **argv)
32 exit (EXIT_FAILURE); 40 exit (EXIT_FAILURE);
33 @} 41 @}
34 42
35 status = mailbox_scan (mbox, &total); 43 mailbox_messages_count (mbox, &total);
36 if (status != 0)
37 @{
38 fprintf (stderr, "mailbox_scan: failed\n");
39 exit (EXIT_FAILURE);
40 @}
41 44
42 for (msgno = 1; msgno <= total; msgno++) 45 for (msgno = 1; msgno <= total; msgno++)
43 @{ 46 @{
......
...@@ -29,69 +29,36 @@ Stream is destroyed without checking for the owner. ...@@ -29,69 +29,36 @@ Stream is destroyed without checking for the owner.
29 @deftypefun void stream_destroy (stream_t *@var{pstream}, void *@var{owner}) 29 @deftypefun void stream_destroy (stream_t *@var{pstream}, void *@var{owner})
30 @end deftypefun 30 @end deftypefun
31 31
32 @deftypefun int stream_set_destroy (stream_t @var{stream}, void (*@var{_destroy})(stream_t @var{stream}), void *@var{owner})
33 @end deftypefun
34
35 @deftypefun int stream_open (stream_t @var{stream}, const char *@var{name}, int@var{port}, int @var{flag}) 32 @deftypefun int stream_open (stream_t @var{stream}, const char *@var{name}, int@var{port}, int @var{flag})
36 @end deftypefun 33 @end deftypefun
37 34
38 @deftypefun int stream_set_open (stream_t @var{stream}, int (*@var{_open})(stream_t, const char *, int, int), void *@var{owner})
39 @end deftypefun
40
41 @deftypefun int stream_close (stream_t @var{stream}) 35 @deftypefun int stream_close (stream_t @var{stream})
42 @end deftypefun 36 @end deftypefun
43 37
44 @deftypefun int stream_set_close (stream_t @var{stream}, int (*@var{_close})(stream_t), void *@var{owner})
45 @end deftypefun
46
47 @deftypefun int stream_get_fd (stream_t @var{stream}, int *@var{pfd}) 38 @deftypefun int stream_get_fd (stream_t @var{stream}, int *@var{pfd})
48 @end deftypefun 39 @end deftypefun
49 40
50 @deftypefun int stream_set_fd (stream_t @var{stream}, int (*@var{_get_fd})(stream_t, int *), void *@var{owner})
51 @end deftypefun
52
53 @deftypefun int stream_read (stream_t @var{stream}, char *@var{buffer}, size_t @var{buflen}, off_t @var{offset}, size_t *@var{pwriten}) 41 @deftypefun int stream_read (stream_t @var{stream}, char *@var{buffer}, size_t @var{buflen}, off_t @var{offset}, size_t *@var{pwriten})
54 @end deftypefun 42 @end deftypefun
55 43
56 @deftypefun int stream_set_read (stream_t @var{stream}, int (*@var{_read})(stream_t, char *, size_t, off_t, size_t *), void *@var{owner})
57 @end deftypefun
58
59 @deftypefun int stream_readline (stream_t @var{stream}, char *@var{buffer}, size_t @var{buflen}, off_t @var{offset}, size_t *@var{pwriten}) 44 @deftypefun int stream_readline (stream_t @var{stream}, char *@var{buffer}, size_t @var{buflen}, off_t @var{offset}, size_t *@var{pwriten})
60 @end deftypefun 45 @end deftypefun
61 46
62 @deftypefun int stream_set_readline (stream_t @var{stream}, int (*@var{_readline})(stream_t, char *, size_t, off_t, size_t *), void *@var{owner})
63 @end deftypefun
64
65 @deftypefun int stream_size (stream_t @var{stream}, off_t *@var{psize}) 47 @deftypefun int stream_size (stream_t @var{stream}, off_t *@var{psize})
66 @end deftypefun 48 @end deftypefun
67 49
68 @deftypefun int stream_set_size (stream_t @var{stream}, int (*@var{_size})(stream_t, off_t *), void *@var{owner})
69 @end deftypefun
70
71 @deftypefun int stream_truncate (stream_t @var{stream}, off_t @var{size}) 50 @deftypefun int stream_truncate (stream_t @var{stream}, off_t @var{size})
72 @end deftypefun 51 @end deftypefun
73 52
74 @deftypefun int stream_set_truncate (stream_t @var{stream}, int (*@var{_truncate})(stream_t, off_t), void *@var{owner})
75 @end deftypefun
76
77 @deftypefun int stream_write (stream_t @var{stream}, const char *@var{buffer}, size_t @var{buflen}, off_t @var{offset}, size_t *@var{pwriten}) 53 @deftypefun int stream_write (stream_t @var{stream}, const char *@var{buffer}, size_t @var{buflen}, off_t @var{offset}, size_t *@var{pwriten})
78 @end deftypefun 54 @end deftypefun
79 55
80 @deftypefun int stream_set_write (stream_t @var{stream}, int (*@var{_write})(stream_t, const char *, size_t, off_t, size_t *), void *@var{owner})
81 @end deftypefun
82
83 @deftypefun int stream_flush (stream_t @var{stream}) 56 @deftypefun int stream_flush (stream_t @var{stream})
84 @end deftypefun 57 @end deftypefun
85 58
86 @deftypefun int stream_set_flush (stream_t @var{stream}, int (*@var{_flush})(stream_t), void *@var{owner})
87 @end deftypefun
88
89 @deftypefun int stream_get_flags (stream_t @var{stream}, int *@var{pflags}) 59 @deftypefun int stream_get_flags (stream_t @var{stream}, int *@var{pflags})
90 @end deftypefun 60 @end deftypefun
91 61
92 @deftypefun int stream_set_flags (stream_t @var{stream}, int @var{flags}, void *@var{owner})
93 @end deftypefun
94
95 @deftypefun int stream_get_state (stream_t @var{stream}, int *@var{pstate}) 62 @deftypefun int stream_get_state (stream_t @var{stream}, int *@var{pstate})
96 @table @code 63 @table @code
97 @item MU_STREAM_STATE_OPEN 64 @item MU_STREAM_STATE_OPEN
......