# # # patch "NEWS" # from [fe3f23ee1811773fac7b5f0586bae10c29792913] # to [5bd1c81eccfa2cbbc21ce0c5f8643f072cd0134e] # # patch "monotone.texi" # from [8fa89059f27e62dedfb3a05328f1fc80b65dd461] # to [56931e1855528bd43e3fc71d71f62bc69e41c7a9] # ============================================================ --- NEWS fe3f23ee1811773fac7b5f0586bae10c29792913 +++ NEWS 5bd1c81eccfa2cbbc21ce0c5f8643f072cd0134e @@ -11,33 +11,32 @@ - Cert labels in the output of the 'log' command are now localized. - - "automate stdio" (and "automate remote_stdio", see below) use - separate streams to encode out-of-band information like - informational messages, warnings or tickers. - A special "header" section has been added to the standard - output to be able to tell stdio version changes between - future versions easier apart. - The error codes used in the output of both, stdio and - remote_stdio, has also slightly changed: errors which are - the result of a wrong call (unknown command, invalid options, - parsing errors, ...) are returned with code 1, while errors - which happened while the actual command executed are returned - with code 2. Error codes are no longer echoed with every - packet, but only as the payload of the final 'l' ("last") - packet. + - "automate stdio" (and "automate remote_stdio", see below) + use separate streams to encode out-of-band information like + informational messages, warnings or tickers. A special + "header" section has been added to the standard output to + identify future stdio version changes. The error codes used + in the output of both stdio and remote_stdio, have also + slightly changed: errors which are the result of a wrong + call (unknown command, invalid options, parsing errors, ...) + are returned with code 1, while errors which happened while + the actual command executed are returned with code 2. Error + codes are no longer echoed with every packet, but only as + the payload of the final 'l' ("last") packet. - Please consult the manual of "mtn automate stdio" for a + Please consult the manual section "mtn automate stdio" for a detailed description of the new format. New features - There's a new command "automate remote_stdio" that makes it - possible to execute automate commands on a remote server (for - example, to permit a single database to be used both for serving - netsync connections and for running a viewmtn instance). This - requires that the server be running monotone 0.46 or later. - Access control on the server is uses a new lua hook - "get_remote_automate_permitted(identity, command_line, options)". + possible to execute automate commands on a remote server + (for example, to permit a single database to be used both + for serving netsync connections and for running a viewmtn + instance). This requires that the server be running monotone + 0.46 or later. Access control on the server uses a new lua + hook "get_remote_automate_permitted(identity, command_line, + options)". - There's also a new command "automate remote" that's very much the same, but executes only a single command and does not ============================================================ --- monotone.texi 8fa89059f27e62dedfb3a05328f1fc80b65dd461 +++ monotone.texi 56931e1855528bd43e3fc71d71f62bc69e41c7a9 @@ -7680,7 +7680,7 @@ @section Automation FIXME -- Introduced out of band streams ('e', 'p', 't', 'w'); the main output of a command now only happens in the 'm' stream; the 'l' stream now marks the end of all streams of a command; introduced the concept of "headers" - which are outputted before the first command is issued; specific error codes + which are output before the first command is issued; specific error codes to distinguish command from interface errors have also been introduced. @item 3.1 -- Added the 'o' item to the recognized input. This change should not @@ -7748,13 +7748,13 @@ @section Automation @item Output format: -Right after a stdio session has been set up, header information are issued; -to date the only header which is issued there is the @code{format-version} -header though, which denotes the version of the stdio format used throughout -the session. The original format had no such version output, so our numbering -starts with a "2" here. +Right after a stdio session has been set up, header information is +issued; to date the only header defined is @code{format-version}, +which denotes the version of the stdio format used throughout the +session. The original format had no such version output, so our +numbering starts with "2" here. -Headers are separated from each other by single newline characters @code{'\n'} +Headers are separated from each other by single newline character @code{'\n'} and from the following output by another newline character. After a command has been issued, one or more packets are returned for it. @@ -7822,14 +7822,14 @@ @section Automation @code{ ::= ';'} @end itemize - The definition tells the implementor the short name and long name of any - upcoming ticker event. The names and meanings are command-specific and - therefor explained for the particular commands which support ticker output. + The definition tells the implementor the short name and long name of +any upcoming ticker event. The names and meanings are command-specific +and are therefore explained in the sections for the particular +commands which support ticker output. - The @code{total_count} might be 0 right at the start and can later be changed to a different number if the command later on knows a more exact value. If - this is the case, this stanza is outputted again with this new value. A + this is the case, this stanza is output again with this new value. A constant @code{total_count} of 0 means that the command may continue to run for a undefined amount of time until the end stanza appears. @@ -7838,12 +7838,12 @@ @section Automation Finally, the end stanza is printed just before the ticker ends (i.e. the work has been done). - All counts output absolute, raw values; no modulation takes place. Its - usually the case that definition, @code{total_count}, advance and end are - printed into separate stanzas. Its also possible that two or more parallel - tickers put out their stanzas at the same time, in this case its ensured that - the output does not get intermixed i.e. at first all definitions are outputted, - afterwards all total_counts, aso. + All counts output absolute, raw values; no modulation takes place. It +is usually the case that definition, @code{total_count}, advance and +end are output in separate stanzas. It is also possible that two or +more parallel tickers output their stanzas at the same time, in this +case it's ensured that the output does not get intermixed; first +all definitions are output, afterwards all total_counts, and so on. @emph{Note:} The ticker format used for stdio is fixed and cannot be selected explicitely via the global @option{--ticker} option. However, if you run an