544c191c34
--- MAJOR NEW FEATURES ---
* apropos(1): improve POSIX compliance by accepting case-insensitive
extended regular expressions by default
* new -O tag[=term] output option (open a page at the definition of a term)
* tbl(7) -T html: spanning and horizontal and vertical alignment of cells
* tbl(7) -T html: draw lines on the edges of table cells
* tbl(7) -T utf8: render lines with the Unicode box drawing characters
* mandoc is now able to handle the manual pages of the groff package.
--- MINOR NEW FEATURES ---
* -T html: new option -O toc (table of contents)
* -T html: second argument to -O man to support local and remote links
* mdoc(7) .Bd -centered now fills the text contained in it
* man-ext .SY and .YS macros (synopsis block)
* man-ext .TQ macro (tagged paragraph without vertical space before it)
* tbl(7) \& explicit alignment indicator
* roff(7) .shift, .while, and .return requests
* roff(7) .char request (output glyph definition)
* roff(7) .nop request (no operation)
* roff(7) .ft request: handle the CB, CI, and CR fonts
* roff(7) .if c conditional (character available)
* roff(7) \\$@ escape sequence (insert all macro arguments, quoted)
* roff(7) \*(.T predefined string (interpolate output device name)
* roff(7) \[charNNN] escape sequence (for printable ASCII characters)
* roff(7) \# escape sequence (line continuation with comment)
--- HTML OUTPUT SYNTAX CORRECTIONS ---
* Render .br and \p as <br/>, not as an empty <div>.
* Render .Pp and .PP as <p> and automatically close it when needed.
* Stop writing empty list elements for non-compact .Bl -tag lists.
* Do not put <p> inside <a> if .UR or .MT contain .PP.
* Implement tooltips purely in CSS rather than abusing title= attributes.
--- MINOR FUNCTIONAL IMPROVEMENTS ---
* many improvements to the handling of fill and no-fill mode
* tbl(7): better column widths in the presence of horizontal spans
* several minor improvements to escape sequence handling
* several minor improvements to manual font handling
* portability: autodetect need for _GNU_SOURCE or _OPENBSD_SOURCE
* portability: autodetect whether less(1) supports the -T option
* large numbers of bugfixes of diverse kinds
--- STRUCTURAL IMPROVEMENTS ---
* Disentangle eqn(7) and tbl(7) from other parser header files,
and clean up some parser data structures.
* Substantially simplify error and warning message infrastructure.
--- THANKS TO ---
* John Gardner for crucial help implementing tooltips in CSS.
* Alexander Bluhm, Raphael Graf, Ted Unangst (OpenBSD)
and Daniel Sabogal (Alpine Linux) for patches.
* Anthony Bentley and Jason McIntyre (OpenBSD) for documentation patches,
suggesting new features, bug reports, and useful discussions.
* Kyle Evans and Baptiste Daroussin (FreeBSD) for minor patches.
* Pali Rohar for suggesting multiple new features and for reporting
several bugs and missing features.
* Klemens Nanni (OpenBSD) for suggesting multiple new features.
* Kristaps Dzonsons (bsd.lv), Marc Espie (OpenBSD), Adam Kalisz,
and Laura Morales for suggesting new features.
* Wolfram Schneider and Yuri Pankov (FreeBSD) for reporting missing features.
* Edward Tomasz Napierala (FreeBSD) for suggesting a feature improvement.
* Thomas Klausner (NetBSD) and Sevan Janiyan (SmartOS)
for bug reports and release testing.
* Bryan Steele, Janne Johansson, Kurt Mosiejczuk, Mike Belopuhov, Theo
Buehler, Todd Miller (OpenBSD), Andreas Gustafsson, Christos Zoulas,
Robert Elz (NetBSD), Kurt Jaeger (FreeBSD), Fabio Scotoni, Kelvin
Sherlock, Mark Harris, Orestis Ioannou, Raf Czlonka, and Sean Farrell
for bug reports.
* Ulrich Spoerlein (FreeBSD), Leah Neukirchen (Void Linux),
Matej Cepl (openSUSE), and Jan Stary (MacOS X) for release testing.
* Brian Callahan and Stuart Henderson (OpenBSD) for help
with the OpenBSD groff port.
* Bertrand Garrigues, Branden Robinson, Ralph Corderoy, and Werner
Lemberg (GNU troff) for checking groff patches.
* Scott Cheloha, Theo de Raadt (OpenBSD)
and Natanael Copa (Alpine Linux) for useful discussions.
118 lines
4.0 KiB
C
118 lines
4.0 KiB
C
/* Id: mansearch.h,v 1.29 2018/11/22 12:01:46 schwarze Exp */
|
|
/*
|
|
* Copyright (c) 2012 Kristaps Dzonsons <kristaps@bsd.lv>
|
|
* Copyright (c) 2013, 2014, 2016, 2017 Ingo Schwarze <schwarze@openbsd.org>
|
|
*
|
|
* Permission to use, copy, modify, and distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice appear in all copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
#define MANDOC_DB "mandoc.db"
|
|
#define MANDOCDB_MAGIC 0x3a7d0cdb
|
|
#define MANDOCDB_VERSION 1
|
|
|
|
#define MACRO_MAX 36
|
|
#define KEY_arch 0
|
|
#define KEY_sec 1
|
|
#define KEY_Nm 38
|
|
#define KEY_Nd 39
|
|
#define KEY_MAX 40
|
|
|
|
#define TYPE_arch 0x0000000000000001ULL
|
|
#define TYPE_sec 0x0000000000000002ULL
|
|
#define TYPE_Xr 0x0000000000000004ULL
|
|
#define TYPE_Ar 0x0000000000000008ULL
|
|
#define TYPE_Fa 0x0000000000000010ULL
|
|
#define TYPE_Fl 0x0000000000000020ULL
|
|
#define TYPE_Dv 0x0000000000000040ULL
|
|
#define TYPE_Fn 0x0000000000000080ULL
|
|
#define TYPE_Ic 0x0000000000000100ULL
|
|
#define TYPE_Pa 0x0000000000000200ULL
|
|
#define TYPE_Cm 0x0000000000000400ULL
|
|
#define TYPE_Li 0x0000000000000800ULL
|
|
#define TYPE_Em 0x0000000000001000ULL
|
|
#define TYPE_Cd 0x0000000000002000ULL
|
|
#define TYPE_Va 0x0000000000004000ULL
|
|
#define TYPE_Ft 0x0000000000008000ULL
|
|
#define TYPE_Tn 0x0000000000010000ULL
|
|
#define TYPE_Er 0x0000000000020000ULL
|
|
#define TYPE_Ev 0x0000000000040000ULL
|
|
#define TYPE_Sy 0x0000000000080000ULL
|
|
#define TYPE_Sh 0x0000000000100000ULL
|
|
#define TYPE_In 0x0000000000200000ULL
|
|
#define TYPE_Ss 0x0000000000400000ULL
|
|
#define TYPE_Ox 0x0000000000800000ULL
|
|
#define TYPE_An 0x0000000001000000ULL
|
|
#define TYPE_Mt 0x0000000002000000ULL
|
|
#define TYPE_St 0x0000000004000000ULL
|
|
#define TYPE_Bx 0x0000000008000000ULL
|
|
#define TYPE_At 0x0000000010000000ULL
|
|
#define TYPE_Nx 0x0000000020000000ULL
|
|
#define TYPE_Fx 0x0000000040000000ULL
|
|
#define TYPE_Lk 0x0000000080000000ULL
|
|
#define TYPE_Ms 0x0000000100000000ULL
|
|
#define TYPE_Bsx 0x0000000200000000ULL
|
|
#define TYPE_Dx 0x0000000400000000ULL
|
|
#define TYPE_Rs 0x0000000800000000ULL
|
|
#define TYPE_Vt 0x0000001000000000ULL
|
|
#define TYPE_Lb 0x0000002000000000ULL
|
|
#define TYPE_Nm 0x0000004000000000ULL
|
|
#define TYPE_Nd 0x0000008000000000ULL
|
|
|
|
#define NAME_SYN 0x0000004000000001ULL
|
|
#define NAME_FIRST 0x0000004000000004ULL
|
|
#define NAME_TITLE 0x0000004000000006ULL
|
|
#define NAME_HEAD 0x0000004000000008ULL
|
|
#define NAME_FILE 0x0000004000000010ULL
|
|
#define NAME_MASK 0x000000000000001fULL
|
|
|
|
enum form {
|
|
FORM_SRC = 1, /* Format is mdoc(7) or man(7). */
|
|
FORM_CAT, /* Manual page is preformatted. */
|
|
FORM_NONE /* Format is unknown. */
|
|
};
|
|
|
|
enum argmode {
|
|
ARG_FILE = 0,
|
|
ARG_NAME,
|
|
ARG_WORD,
|
|
ARG_EXPR
|
|
};
|
|
|
|
struct manpage {
|
|
char *file; /* to be prefixed by manpath */
|
|
char *names; /* a list of names with sections */
|
|
char *output; /* user-defined additional output */
|
|
size_t ipath; /* number of the manpath */
|
|
int sec; /* section number, 10 means invalid */
|
|
enum form form;
|
|
};
|
|
|
|
struct mansearch {
|
|
const char *arch; /* architecture/NULL */
|
|
const char *sec; /* mansection/NULL */
|
|
const char *outkey; /* show content of this macro */
|
|
enum argmode argmode; /* interpretation of arguments */
|
|
int firstmatch; /* first matching database only */
|
|
};
|
|
|
|
|
|
struct manpaths;
|
|
|
|
int mansearch(const struct mansearch *cfg, /* options */
|
|
const struct manpaths *paths, /* manpaths */
|
|
int argc, /* size of argv */
|
|
char *argv[], /* search terms */
|
|
struct manpage **res, /* results */
|
|
size_t *ressz); /* results returned */
|
|
void mansearch_free(struct manpage *, size_t);
|