# # # patch "monotone.texi" # from [0613546310d5627ac20feb0fcbecc27d63bf2f6e] # to [84b44ce4da7b2b892c6759abb901af9109b2ee34] # ============================================================ --- monotone.texi 0613546310d5627ac20feb0fcbecc27d63bf2f6e +++ monotone.texi 84b44ce4da7b2b892c6759abb901af9109b2ee34 @@ -8826,7 +8826,7 @@ @section Automation @item Purpose: -Prints the contents of the manifest associated with the given roster. +Prints the contents of the manifest associated with the given revision. @item Sample output: @@ -8954,6 +8954,122 @@ @section Automation @end table address@hidden mtn automate get_extended_manifest_of @var{revid} + address@hidden @strong address@hidden Arguments: + +The @var{revid} specifies the revision for which the extended manifest +should be printed. + address@hidden Added in: + +13.0 + address@hidden Purpose: + +Prints the contents of the extended manifest associated with the given revision. + address@hidden Sample output: + address@hidden + dir "" + birth [0cd607d6dda3a2df18f777112947f3c70811581e] +path_mark [0cd607d6dda3a2df18f777112947f3c70811581e] + + dir "dir" +dormant_attr "dirprop" + birth [0cd607d6dda3a2df18f777112947f3c70811581e] + path_mark [0cd607d6dda3a2df18f777112947f3c70811581e] + attr_mark "dirprop" [a7a71d7cc0d526165e7362b8a87393d8609f40c2] + + file "file" + content [d3395867d05cc4c27f013d6e6f48d644e96d8241] + size "8" + attr "fileprop" "value" + birth [0cd607d6dda3a2df18f777112947f3c70811581e] + path_mark [0cd607d6dda3a2df18f777112947f3c70811581e] +content_mark [a7a71d7cc0d526165e7362b8a87393d8609f40c2] + attr_mark "fileprop" [a7a71d7cc0d526165e7362b8a87393d8609f40c2] address@hidden verbatim + address@hidden Output format: + +There is one basic_io stanza for each file or directory in the +extended manifest. + +All stanzas are formatted by basic_io. Stanzas are separated +by a blank line. Values will be escaped, '\' to '\\' and +'"' to '\"'. + +The 'dir' and 'file' lines are the first in every stanza and +specify its type as follows: + address@hidden +'dir': + Represents a directory. The path "" (the empty string) is used + to represent the root of the tree. + format: ('dir', pathname) + occurs: one or more times +'file': + Represents a file. + format: ('file', pathname) + occurs: zero or more times address@hidden verbatim + +In addition, both 'dir' and 'file' stanzas include more information +on the particular node: + address@hidden +'birth': + The revision id in which the node was added ("born"). + format: ('birth', revision id) + occurs: once per node +'path_mark': + The revision id in which the node was last renamed. + format: ('path_mark', revision id) + occurs: once per node +'content': + The id of the file node, i.e. the hash of its contents. + format: ('content', file id) + occurs: once per file node +'content_mark': + The revision id in which the node's content was changed at last. + format: ('content_mark', revision id) + occurs: once per file node +'size': + The recorded file size, in bytes. + format: ('size', size in bytes) + occurs: once per file node address@hidden verbatim + +Finally, attributes are also part of the format: + address@hidden +'attr': + The name and the value of a specific attribute. + format: ('attr', attribute name, attribute value) + occurs: zero or more times per node +'dormant_attr': + The name of a previously deleted attribute. + format: ('dormant_attr', attribute name) + occurs: zero or more times per node +'attr_mark': + The revision id in which a particular attribute's value was + changed at last. + format: ('attr_mark', attribute name, revision id) + occurs: zero or more times per node address@hidden verbatim + +All stanzas are sorted by the path string. + address@hidden Error conditions: + +If the revision ID specified is unknown or invalid prints an error +message to stderr and exits with status 1. + address@hidden table + @item mtn automate get_attributes @var{path} @table @strong @@ -9242,6 +9358,43 @@ @section Automation @end table address@hidden mtn automate get_file_size @var{id} + address@hidden @strong address@hidden Arguments: + +The @var{id} argument specifies the file hash of the file for which +the size should be printed. + address@hidden Added in: + +13.0 + address@hidden Purpose: + +Prints the recorded file size of the specified file. + +If you need to know the file sizes of multiple files of the same revision, +its usually faster to use the @command{automate get_extended_manifest_of} +command. + address@hidden Sample output: + address@hidden +1241 address@hidden verbatim + address@hidden Output format: + +The size of the file in bytes followed by a linefeed character ('\n'). + address@hidden Error conditions: + +If the file id specified is unknown or invalid prints an error message +to stderr and exits with status 1. + address@hidden table + @item mtn automate file_merge @var{left-rid} @var{left-path} @var{right-rid} @var{right-path} @table @strong