Documentation/SubmittingPatches: Gnus tips
[git] / xdiff / xdiff.h
1 /*
2  *  LibXDiff by Davide Libenzi ( File Differential Library )
3  *  Copyright (C) 2003  Davide Libenzi
4  *
5  *  This library is free software; you can redistribute it and/or
6  *  modify it under the terms of the GNU Lesser General Public
7  *  License as published by the Free Software Foundation; either
8  *  version 2.1 of the License, or (at your option) any later version.
9  *
10  *  This library is distributed in the hope that it will be useful,
11  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  *  Lesser General Public License for more details.
14  *
15  *  You should have received a copy of the GNU Lesser General Public
16  *  License along with this library; if not, write to the Free Software
17  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18  *
19  *  Davide Libenzi <davidel@xmailserver.org>
20  *
21  */
22
23 #if !defined(XDIFF_H)
24 #define XDIFF_H
25
26 #ifdef __cplusplus
27 extern "C" {
28 #endif /* #ifdef __cplusplus */
29
30
31 #define XDF_NEED_MINIMAL (1 << 1)
32 #define XDF_IGNORE_WHITESPACE (1 << 2)
33 #define XDF_IGNORE_WHITESPACE_CHANGE (1 << 3)
34 #define XDF_WHITESPACE_FLAGS (XDF_IGNORE_WHITESPACE | XDF_IGNORE_WHITESPACE_CHANGE)
35
36 #define XDL_PATCH_NORMAL '-'
37 #define XDL_PATCH_REVERSE '+'
38 #define XDL_PATCH_MODEMASK ((1 << 8) - 1)
39 #define XDL_PATCH_IGNOREBSPACE (1 << 8)
40
41 #define XDL_EMIT_FUNCNAMES (1 << 0)
42 #define XDL_EMIT_COMMON (1 << 1)
43
44 #define XDL_MMB_READONLY (1 << 0)
45
46 #define XDL_MMF_ATOMIC (1 << 0)
47
48 #define XDL_BDOP_INS 1
49 #define XDL_BDOP_CPY 2
50 #define XDL_BDOP_INSB 3
51
52 #define XDL_MERGE_MINIMAL 0
53 #define XDL_MERGE_EAGER 1
54 #define XDL_MERGE_ZEALOUS 2
55
56 typedef struct s_mmfile {
57         char *ptr;
58         long size;
59 } mmfile_t;
60
61 typedef struct s_mmbuffer {
62         char *ptr;
63         long size;
64 } mmbuffer_t;
65
66 typedef struct s_xpparam {
67         unsigned long flags;
68 } xpparam_t;
69
70 typedef struct s_xdemitcb {
71         void *priv;
72         int (*outf)(void *, mmbuffer_t *, int);
73 } xdemitcb_t;
74
75 typedef struct s_xdemitconf {
76         long ctxlen;
77         unsigned long flags;
78 } xdemitconf_t;
79
80 typedef struct s_bdiffparam {
81         long bsize;
82 } bdiffparam_t;
83
84
85 #define xdl_malloc(x) malloc(x)
86 #define xdl_free(ptr) free(ptr)
87 #define xdl_realloc(ptr,x) realloc(ptr,x)
88
89 void *xdl_mmfile_first(mmfile_t *mmf, long *size);
90 void *xdl_mmfile_next(mmfile_t *mmf, long *size);
91 long xdl_mmfile_size(mmfile_t *mmf);
92
93 int xdl_diff(mmfile_t *mf1, mmfile_t *mf2, xpparam_t const *xpp,
94              xdemitconf_t const *xecfg, xdemitcb_t *ecb);
95
96 int xdl_merge(mmfile_t *orig, mmfile_t *mf1, const char *name1,
97                 mmfile_t *mf2, const char *name2,
98                 xpparam_t const *xpp, int level, mmbuffer_t *result);
99
100 #ifdef __cplusplus
101 }
102 #endif /* #ifdef __cplusplus */
103
104 #endif /* #if !defined(XDIFF_H) */
105