815834e9aa
Range specification -L/RE/ for blame/log unconditionally begins searching at line one. Mailing list discussion [1] suggests that, in the presence of multiple -L options, -L/RE/ should search relative to the endpoint of the previous -L range, if any. Teach the parsing machinery underlying blame's and log's -L options to accept a start point for -L/RE/ searches. Follow-up patches will upgrade blame and log to take advantage of this ability. [1]: http://thread.gmane.org/gmane.comp.version-control.git/229755/focus=229966 Signed-off-by: Eric Sunshine <sunshine@sunshineco.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
40 lines
1.3 KiB
C
40 lines
1.3 KiB
C
#ifndef LINE_RANGE_H
|
|
#define LINE_RANGE_H
|
|
|
|
/*
|
|
* Parse one item in an -L begin,end option w.r.t. the notional file
|
|
* object 'cb_data' consisting of 'lines' lines.
|
|
*
|
|
* The 'nth_line_cb' callback is used to determine the start of the
|
|
* line 'lno' inside the 'cb_data'. The caller is expected to already
|
|
* have a suitable map at hand to make this a constant-time lookup.
|
|
*
|
|
* 'anchor' is the 1-based line at which relative range specifications
|
|
* should be anchored. Absolute ranges are unaffected by this value.
|
|
*
|
|
* Returns 0 in case of success and -1 if there was an error. The
|
|
* actual range is stored in *begin and *end. The counting starts
|
|
* at 1! In case of error, the caller should show usage message.
|
|
*/
|
|
|
|
typedef const char *(*nth_line_fn_t)(void *data, long lno);
|
|
|
|
extern int parse_range_arg(const char *arg,
|
|
nth_line_fn_t nth_line_cb,
|
|
void *cb_data, long lines, long anchor,
|
|
long *begin, long *end,
|
|
const char *path);
|
|
|
|
/*
|
|
* Scan past a range argument that could be parsed by
|
|
* 'parse_range_arg', to help the caller determine the start of the
|
|
* filename in '-L n,m:file' syntax.
|
|
*
|
|
* Returns a pointer to the first character after the 'n,m' part, or
|
|
* NULL in case the argument is obviously malformed.
|
|
*/
|
|
|
|
extern const char *skip_range_arg(const char *arg);
|
|
|
|
#endif /* LINE_RANGE_H */
|