[Monotone-devel] seeming documentation inconsistencies - 0.24 windows distribution

[David Hoke]

The documentation appears to have differences between the command summaries on the HTML pages and the (HTML version of) man pages.

 

I have specifically observed what seem to be differences in the "log" and "cat" entries.  "annotate" seems to be missing from the man page.

 

(I have not made an exhaustive comparison, was just trying to find commands to achieve my objectives.)

 

It appears the 5.x versions for these items match the program - of course I found the 8.x man page versions first.

 

==================================================================

From file:///C:/Program%20Files/monotone/documentation/Commands.html#Commands:

 

8.2.2 Commands

...

 

 

log [id]

Show historical log of revisions, starting from working copy base revision, or [id] if given.

 

 

cat (file <id>|manifest [<id>]|revision [<id>])

Write file, manifest or revision from database to stdout.

 

***"annotate" not mentioned on this page

 

=================================================================

From file:///C:/Program%20Files/monotone/documentation/Informative.html#Informative

 

 

5.4 Informative

...

 

monotone log

monotone log [--last=n] [--revision=id [...]] [--brief] [file [...]]

This command prints out a log, in reverse-ancestry order, of small history summaries. Each summary contains author, date, changelog and comment information associated with a revision. If --brief is given, the output consists of one line per revision with the revision ID, the author, the date and the branches (separated with commas).

If --last=n is given, at most that many log entries will be given.

If one or more revision IDs are given, the command starts tracing back through history from these revisions, otherwise it starts from the base revision of your working copy.

If one or more files are given, the command will only log the revisions where those files are changed.

5.1 Tree

 

monotone cat path

monotone cat --revision=id path

Write the contents of a specific file path to standard output.

Without a --revision argument, the command outputs the contents of path as found in the current revision. This requires the command be executed from within a working copy.

With an explicit --revision argument, the command outputs contents of path at that revision.

===============================================================================

monotone 0.24 (base revision: d59847072bb689e952ab21db7f9fababdb80a19f)
Running on: Windows NT/2000/XP (5.1, build 2600) on ia32 (level 15, rev 1027)
Changes since base revision:
new_manifest [372d1c1e2c97f00c8a329d7f2dfae6ba28fe1db6]

old_revision [d59847072bb689e952ab21db7f9fababdb80a19f]
old_manifest [372d1c1e2c97f00c8a329d7f2dfae6ba28fe1db6]

  Generated from data cached in the distribution;
  further changes may have been made.

  Generated from data cached in the distribution;
  further changes may have been made.

  Generated from data cached in the distribution;
  further changes may have been made.

  Generated from data cached in the distribution;
  further changes may have been made.

  Generated from data cached in the distribution;
  further changes may have been made.

  Generated from data cached in the distribution;
  further changes may have been made.