CVS log for mandoc/apropos.1

[BACK] Up to [cvsweb.bsd.lv] / mandoc

Request diff between arbitrary revisions


Default branch: MAIN
Current tag: MAIN


Revision 1.51 / (download) - annotate - [select for diffs], Thu Oct 1 22:50:00 2020 UTC (3 years, 5 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_6, HEAD
Changes since 1.50: +6 -2 lines
Diff to previous 1.50 (unified) to selected 1.45 (unified)

add example to apropos.1 to list all manuals in a given section;
patch from ians@

Revision 1.50 / (download) - annotate - [select for diffs], Mon Jul 20 16:57:29 2020 UTC (3 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.49: +5 -6 lines
Diff to previous 1.49 (unified) to selected 1.45 (unified)

Switch the default pager from "more -s" to "less".

POSIX explicitly allows using a different default pager if that is
documented.  Nowadays, the pager provided in most operating systems
is less(1).  Our man(1) implementation uses less(1) features that
traditional more(1) did not provide, in particular tagging.  Besides,
as noted by deraadt@, the user interface of less(1) is slightly
more refined and preferable over the user inferface of more(1).
This switch was originally suggested by Ian Ropers.

In ./configure, test whether less(1) is available.  If not, fall
back to more(1).  In ./configure.local, support overriding the
automatic test by setting BINM_PAGER.

As explained by jmc@ and deraadt@, the -s flag was added a very
long time ago when an antique version of groff(1) had an annoying
bug in terminal output that would randomly display blank lines in
the middle of pages.  Clearly, -s has no longer been needed for
many years, so drop it from the default pager invocation.

OK deraadt@ jmc@ martijn@ job@ on the OpenBSD version of this patch.

Revision 1.49 / (download) - annotate - [select for diffs], Thu Nov 22 12:33:52 2018 UTC (5 years, 4 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_5
Changes since 1.48: +4 -20 lines
Diff to previous 1.48 (unified) to selected 1.45 (unified)

Correct and shorten the description of the sort order of apropos(1)
results.  As a matter of fact, which manpath the page comes from
does not matter in that context.  That only matters for the priority
of pages in man(1) mode (without -a, -f, and -k).

Noticed while working on a patch from Yuri Pankov <yuripv at FreeBSD>.

Revision 1.48 / (download) - annotate - [select for diffs], Mon Nov 19 19:27:37 2018 UTC (5 years, 4 months ago) by schwarze
Branch: MAIN
Changes since 1.47: +29 -12 lines
Diff to previous 1.47 (unified) to selected 1.45 (unified)

Improve POSIX compliance by making case-insensitive extended
regular expressions the default in man(1) -k searches, also matching
what the man-db package used by many Linux distributions does.

Originally requested by Wolfram Schneider <wosch at FreeBSD>
via Yuri Pankov <yuripv at FreeBSD>.

Feedback and OK cheloha@, and no objections when shown on tech@.

Thanks to cheloha@ for pointing out that POSIX requires this behaviour
and for the suggestion to explicitly say that *extended* regular
expressions are used here.

While here, unify spelling of case-[in]sensitive, fix a typo,
update the EXAMPLES, and add a STANDARDS section.

Revision 1.47 / (download) - annotate - [select for diffs], Fri Feb 23 18:54:02 2018 UTC (6 years, 1 month ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_4
Changes since 1.46: +25 -2 lines
Diff to previous 1.46 (unified) to selected 1.45 (unified)

clarify documentation of macro keys

Revision 1.46 / (download) - annotate - [select for diffs], Tue Jul 4 23:40:01 2017 UTC (6 years, 8 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_3, VERSION_1_14_2
Changes since 1.45: +2 -2 lines
Diff to previous 1.45 (unified)

various nits found with mandoc -Tlint

Revision 1.45 / (download) - annotate - [selected], Mon Mar 27 18:51:36 2017 UTC (7 years ago) by schwarze
Branch: MAIN
Changes since 1.44: +3 -3 lines
Diff to previous 1.44 (unified)

simplify the SYNOPSIS as well, just like the option lists;
suggested by and OK jmc@

Revision 1.44 / (download) - annotate - [select for diffs], Mon Mar 27 14:40:39 2017 UTC (7 years ago) by schwarze
Branch: MAIN
Changes since 1.43: +5 -12 lines
Diff to previous 1.43 (unified) to selected 1.45 (unified)

Simplify: mention at one place that -fkl override each other,
rather than stating it separately for each option.
Suggested, OKed, and tweaked by jmc@.

Revision 1.43 / (download) - annotate - [select for diffs], Sat Mar 25 12:46:36 2017 UTC (7 years ago) by schwarze
Branch: MAIN
Changes since 1.42: +7 -29 lines
Diff to previous 1.42 (unified) to selected 1.45 (unified)

For some options that are rarely needed in apropos(1) and man(1),
delete the verbose descriptions and point to man(1) and mandoc(1),
respectively, instead.  That shortens the pages and makes them
easier to read.
Tweaks and OK jmc@, based in part on ideas from tedu@.

Revision 1.42 / (download) - annotate - [select for diffs], Sat Mar 18 19:51:19 2017 UTC (7 years ago) by schwarze
Branch: MAIN
Changes since 1.41: +24 -19 lines
Diff to previous 1.41 (unified) to selected 1.45 (unified)

Correct description of MANPATH, and a few more improvements
to the ENVIRONMENT section; OK jmc@

Revision 1.41 / (download) - annotate - [select for diffs], Fri Mar 17 17:24:41 2017 UTC (7 years ago) by schwarze
Branch: MAIN
Changes since 1.40: +25 -4 lines
Diff to previous 1.40 (unified) to selected 1.45 (unified)

Document man(1) section selection priority,
and correct description of apropos(1) output search order.
Suggested by tb@.

Revision 1.40 / (download) - annotate - [select for diffs], Tue Jan 31 19:44:04 2017 UTC (7 years, 1 month ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_1, VERSION_1_13
Changes since 1.39: +6 -2 lines
Diff to previous 1.39 (unified) to selected 1.45 (unified)

add missing HISTORY information

Revision 1.39 / (download) - annotate - [select for diffs], Fri Apr 3 08:46:17 2015 UTC (8 years, 11 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_4
Changes since 1.38: +4 -3 lines
Diff to previous 1.38 (unified) to selected 1.45 (unified)

No need to hardcode /usr/bin/ as the path to more(1); helps portability.
We don't hardcode the paths to gunzip(1) and cmp(1) either.
Discussed with ajacoutot@.

Revision 1.38 / (download) - annotate - [select for diffs], Mon Mar 30 16:06:14 2015 UTC (9 years ago) by schwarze
Branch: MAIN
Changes since 1.37: +8 -8 lines
Diff to previous 1.37 (unified) to selected 1.45 (unified)

Escape punctuation characters that have a different meaning in -Tpdf.

~, `, and ' get translated to non-ASCII characters by most troff
implementations when generating PostScript/PDF output.  When the
original ASCII character is meant, it needs to be manually escaped.

Patch from bentley@.

Revision 1.37 / (download) - annotate - [select for diffs], Mon Feb 16 16:23:54 2015 UTC (9 years, 1 month ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_3
Changes since 1.36: +3 -5 lines
Diff to previous 1.36 (unified) to selected 1.45 (unified)

Delete the -V option.  It serves no purpose but keeps confusing people.

Keeping track of the versions of installed software is the job of
the package manager, not of the individual binaries.  If individual
binaries include version numbers, that tends to goad people into
writing broken configuration tests that inspect version numbers
instead of properly testing for features.

Revision 1.36 / (download) - annotate - [select for diffs], Sat Oct 25 01:03:52 2014 UTC (9 years, 5 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_2
Changes since 1.35: +3 -3 lines
Diff to previous 1.35 (unified) to selected 1.45 (unified)

integrate preconv(1) into mandoc(1);
enhances functionality and reduces code and docs by more than 300 lines

Revision 1.35 / (download) - annotate - [select for diffs], Wed Sep 3 05:22:45 2014 UTC (9 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.34: +8 -3 lines
Diff to previous 1.34 (unified) to selected 1.45 (unified)

Implement the traditional -h option for man(1): show the SYNOPSIS only.
As usual, we get mandoc -h and apropos -h for free.
Try stuff like "apropos -h In=dirent" or "apropos -h Fa=timespec".

Only useful for terminal output, so -Tps, -Tpdf, -Thtml ignore -h for now.

Revision 1.34 / (download) - annotate - [select for diffs], Sat Aug 30 18:08:10 2014 UTC (9 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.33: +20 -4 lines
Diff to previous 1.33 (unified) to selected 1.45 (unified)

Introduce a man(1) -l option as an alias for mandoc -a.
Basically, this does the same as man -l in Linux man-db.
The point is that now all functionality of the combined tool
is reachable from the man(1) command name:
apropos = man -k, whatis = man -f, mandoc = man -cl.

Originally suggested by Carsten dot Kunze at arcor dot de,
current maintainer of the Heirloom Documentation Tools.

While here, add various missing information to the usage()
and to the manuals.

Revision 1.33 / (download) - annotate - [select for diffs], Fri Aug 22 04:52:55 2014 UTC (9 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.32: +15 -3 lines
Diff to previous 1.32 (unified) to selected 1.45 (unified)

implement MANPAGER and PAGER

Revision 1.32 / (download) - annotate - [select for diffs], Fri Aug 22 03:42:18 2014 UTC (9 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.31: +16 -3 lines
Diff to previous 1.31 (unified) to selected 1.45 (unified)

mandoc -a, man, apropos -a, whatis -a now paginate by default
but provide an option -c to not paginate;
taking inspiration from manpage.c, hence adding (c) 2012 kristaps@

Revision 1.31 / (download) - annotate - [select for diffs], Thu Aug 21 02:28:40 2014 UTC (9 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.30: +44 -9 lines
Diff to previous 1.30 (unified) to selected 1.45 (unified)

Describe the new options -afkw.
Clean up the description of whatis(1).

Revision 1.30 / (download) - annotate - [select for diffs], Thu Aug 21 01:52:59 2014 UTC (9 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.29: +26 -8 lines
Diff to previous 1.29 (unified) to selected 1.45 (unified)

Complete the whatis.1 -> apropos.1 merge,
in particular regarding HISTORY and AUTHORS.

Revision 1.29 / (download) - annotate - [select for diffs], Thu Apr 24 00:28:19 2014 UTC (9 years, 11 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_1
Changes since 1.28: +3 -3 lines
Diff to previous 1.28 (unified) to selected 1.45 (unified)

misplaced punctuation

Revision 1.28 / (download) - annotate - [select for diffs], Fri Apr 18 10:30:37 2014 UTC (9 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.27: +9 -9 lines
Diff to previous 1.27 (unified) to selected 1.45 (unified)

Slowly, the dust begins to settle.
We are keeping the traditional name makewhatis(8).
No content change.

Revision 1.27 / (download) - annotate - [select for diffs], Fri Apr 18 09:47:09 2014 UTC (9 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.26: +32 -25 lines
Diff to previous 1.26 (unified) to selected 1.45 (unified)

Fix a few lies; polish wording and formatting while here.

Revision 1.26 / (download) - annotate - [select for diffs], Tue Apr 15 23:02:27 2014 UTC (9 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.25: +1 -2 lines
Diff to previous 1.25 (unified) to selected 1.45 (unified)

remove documentation of the former macro key "NAME";
it got deleted with mansearch.h rev. 1.12

Revision 1.25 / (download) - annotate - [select for diffs], Fri Apr 4 15:55:19 2014 UTC (9 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.24: +4 -2 lines
Diff to previous 1.24 (unified) to selected 1.45 (unified)

Remember which names are in the NAME section.
This helps to find missing MLINKS.
Database build times do not change and database growth is minimal
(1.2% with -Q, 0.7% without -Q in /usr/share/man),
so making this optional would be pointless.

Revision 1.24 / (download) - annotate - [select for diffs], Fri Apr 4 15:51:28 2014 UTC (9 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.23: +22 -4 lines
Diff to previous 1.23 (unified) to selected 1.45 (unified)

merge OpenBSD rev. 1.20, describing new features

Revision 1.23 / (download) - annotate - [select for diffs], Mon Mar 17 09:43:56 2014 UTC (10 years ago) by schwarze
Branch: MAIN
Changes since 1.22: +153 -57 lines
Diff to previous 1.22 (unified) to selected 1.45 (unified)

Sync to OpenBSD:
* do not talk about shell globbing
* describe logical operations
* improve examples
* add HISTORY
* some wording improvements for clarity

Revision 1.22 / (download) - annotate - [select for diffs], Tue Oct 1 20:56:18 2013 UTC (10 years, 5 months ago) by schwarze
Branch: MAIN
Changes since 1.21: +3 -3 lines
Diff to previous 1.21 (unified) to selected 1.45 (unified)

Merge the relevant parts from the VERSION_1_12 branch:
- change mandocdb.db to mandoc.db
- add HISTORY to mandocdb(8)

Revision 1.21 / (download) - annotate - [select for diffs], Sat Jul 13 19:41:16 2013 UTC (10 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.20: +3 -4 lines
Diff to previous 1.20 (unified) to selected 1.45 (unified)

For citing the names and email addresses of authors,
consistently use the style ".An name Aq Mt email".

Triggered by a question from Jan Stary <hans at stare dot cz>,
ok jmc@.

Revision 1.20 / (download) - annotate - [select for diffs], Fri Jul 5 09:33:02 2013 UTC (10 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.19: +6 -6 lines
Diff to previous 1.19 (unified) to selected 1.45 (unified)

Simple partial sync with OpenBSD:
* Again accept suffixes on the name of the whatis utility.
* The usage line for whatis must not invite expressions.
* Revert the argument names in the SYNOPSIS back to the usual ones.
* Revert a few gratuitious changes regarding line breaks etc.

Revision 1.19 / (download) - annotate - [select for diffs], Sat Jun 9 14:11:15 2012 UTC (11 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.18: +21 -15 lines
Diff to previous 1.18 (unified) to selected 1.45 (unified)

Merge whatis.1 into apropos.1 (and remove), add whatis bits to apropos
(via mansearch), and merge mandocdb.h into mansearch.h (and remove).

Revision 1.18 / (download) - annotate - [select for diffs], Fri Jun 8 10:44:52 2012 UTC (11 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.17: +26 -94 lines
Diff to previous 1.17 (unified) to selected 1.45 (unified)

Flip apropos to use mansearch instead of apropos_db.
This makes the utility much smaller and simpler.
A lot of functionality has been omitted while the sqlite3 search routines
improve (logical operations, etc.).
It still needs work to make the output more conventional.
Also add the manpage utility, which I use extensively as a mind-meld of
apropos and man.

Revision 1.17 / (download) - annotate - [select for diffs], Sat Mar 24 01:46:25 2012 UTC (12 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_12_1
Changes since 1.16: +27 -11 lines
Diff to previous 1.16 (unified) to selected 1.45 (unified)

Be insane.  Make apropos(1) subsume man(1).

Revision 1.16 / (download) - annotate - [select for diffs], Sun Dec 25 19:35:44 2011 UTC (12 years, 3 months ago) by kristaps
Branch: MAIN
Branch point for: VERSION_1_12
Changes since 1.15: +16 -14 lines
Diff to previous 1.15 (unified) to selected 1.45 (unified)

State default usage before listing arguments of a utility.  Inspired by a
patch to mandocdb.8 by schwarze@ some time ago.  Ok jmc@.

Revision 1.15 / (download) - annotate - [select for diffs], Sun Dec 25 16:53:51 2011 UTC (12 years, 3 months ago) by schwarze
Branch: MAIN
Changes since 1.14: +4 -4 lines
Diff to previous 1.14 (unified) to selected 1.45 (unified)

Use the traditional name "whatis.db" for the mandocdb(8) databases.
Requested by deraadt@, ok kristaps@.

Revision 1.14 / (download) - annotate - [select for diffs], Sat Dec 24 22:37:16 2011 UTC (12 years, 3 months ago) by kristaps
Branch: MAIN
Changes since 1.13: +14 -3 lines
Diff to previous 1.13 (unified) to selected 1.45 (unified)

Support leading, trailing and double colons in MANPATH to prepend,
append or insert the man.conf(5) default path; compatible with GNU
manpath(1), implementation by kristaps@, heavily tweaked by schwarze@.

Updates to MANPATH documentation applied to whatis.1, apropos.1, and
catman.8 also.

Revision 1.13 / (download) - annotate - [select for diffs], Mon Dec 12 02:00:49 2011 UTC (12 years, 3 months ago) by schwarze
Branch: MAIN
Changes since 1.12: +24 -2 lines
Diff to previous 1.12 (unified) to selected 1.45 (unified)

implement -C (alternative config file) for apropos(1) and mandocdb(8),
including various tweaks to the whatis(8) manual;
ok kristaps@

Revision 1.12 / (download) - annotate - [select for diffs], Tue Nov 29 10:59:19 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.11: +2 -2 lines
Diff to previous 1.11 (unified) to selected 1.45 (unified)

Snip some whitespace from apropos(1) and remove mandoc(1) ref from
whatis(1) (both apropos/whatis aren't related to mandoc from an
operator's perspective).

Revision 1.11 / (download) - annotate - [select for diffs], Tue Nov 29 10:53:42 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.10: +18 -24 lines
Diff to previous 1.10 (unified) to selected 1.45 (unified)

Make `-i' only apply to regular expressions.  For the equality operator
(and thus the default), always use strcasestr().  Discussed on tech@
with schwarze@.  While here, fix the apropos.c usage() message to be
consistent with apropos(1) and clean up the EXAMPLES in apropos(1).

Revision 1.10 / (download) - annotate - [select for diffs], Tue Nov 29 00:41:33 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.9: +84 -6 lines
Diff to previous 1.9 (unified) to selected 1.45 (unified)

Add tables of matchable keys into apropos.1.  Ok and with feedback by
schwarze@.

Revision 1.9 / (download) - annotate - [select for diffs], Sat Nov 26 22:38:11 2011 UTC (12 years, 4 months ago) by schwarze
Branch: MAIN
Changes since 1.8: +5 -5 lines
Diff to previous 1.8 (unified) to selected 1.45 (unified)

Sync to OpenBSD, mostly gratuitous and whitespace differences,
but a few serious things as well:
* -M overrides MANPATH
* -m prepends to the path
* put back database close calls that got lost in mandocdb
* missing sys/types.h in manpath.c, needed for size_t
ok kristaps@

Revision 1.8 / (download) - annotate - [select for diffs], Wed Nov 23 10:09:30 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.7: +2 -3 lines
Diff to previous 1.7 (unified) to selected 1.45 (unified)

Fix whitespace in manuals.

Revision 1.7 / (download) - annotate - [select for diffs], Sun Nov 20 21:36:00 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.6: +14 -4 lines
Diff to previous 1.6 (unified) to selected 1.45 (unified)

Initial support for man.conf/makepath(1).

Revision 1.6 / (download) - annotate - [select for diffs], Sun Nov 20 16:29:50 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.5: +13 -21 lines
Diff to previous 1.5 (unified) to selected 1.45 (unified)

Clarify some behaviour, bringing schwarze@'s patch and mine closer together
(although I still don't have -M, which is a big piece).

First, the default search path is the cwd.  This will change to use -M
once I look over that code.

If MANPATH is specified, this replaces the cwd.

Both of these are augmented by -m.

If paths don't exist or don't have databases, they're silently ignored.
This makes perfect sense: you may be given a superset of possible paths.
The corner case of no paths (where, say, MANPATH consists of bogus paths
or the cwd is unreadable) simply means that no paths are searched.

Revision 1.5 / (download) - annotate - [select for diffs], Sun Nov 20 15:43:14 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.4: +14 -5 lines
Diff to previous 1.4 (unified) to selected 1.45 (unified)

Integrate a moderately-patched version of schwarze@'s support for multiple
directories containing mandocdb(8) databases.  Some changes follow:

 (1) don't support -M yet;
 (2) fall back to cwd if no prior manpath has been specified;
 (3) resolve manpages using realpath() to prevent consecutive chdir()'s
     over relative paths;
 (4) note where further error-reporting is required;
 (5) fix leaking memory on exit in several cases.

Revision 1.4 / (download) - annotate - [select for diffs], Fri Nov 18 07:02:19 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.3: +96 -52 lines
Diff to previous 1.3 (unified) to selected 1.45 (unified)

Evaluation with logical subexpressions.  This allows support for arbitrary,
nested logical subexpressions with AND (-a) and OR (-o) support.

Revision 1.3 / (download) - annotate - [select for diffs], Wed Nov 9 10:53:48 2011 UTC (12 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.2: +21 -40 lines
Diff to previous 1.2 (unified) to selected 1.45 (unified)

Change getopt() to be more like schwarze@'s suggestions.

Revision 1.2 / (download) - annotate - [select for diffs], Sat Oct 8 12:24:40 2011 UTC (12 years, 5 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_12_0
Changes since 1.1: +4 -3 lines
Diff to previous 1.1 (unified) to selected 1.45 (unified)

Use `Mt' instead of `Aq' for email address.

Revision 1.1 / (download) - annotate - [select for diffs], Thu Oct 6 23:00:54 2011 UTC (12 years, 5 months ago) by kristaps
Branch: MAIN
Diff to selected 1.45 (unified)

Import apropos from mandoc-tools after inlining all source files
(originally including extern.h, state.c, and sort.c).  The apropos
utility interfaces with the databases of mandocdb to provide semantic
searching capabilities.  It Works For Me, but will need lots of cleanup
in the coming months.

This form allows you to request diff's between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.




CVSweb