Magellan Linux

  • Back to homepage
    • /[magellan-source]/trunk/pkgtools/svn2cl-0.14/svn2cl.1

    Annotation of /trunk/pkgtools/svn2cl-0.14/svn2cl.1

    Parent Directory Parent Directory | Revision Log Revision Log

    Revision 3106 - (hide annotations) (download)
    Fri Mar 15 10:20:17 2019 UTC (5 years, 1 month ago) by niro
    File size: 9060 byte(s) 
    -added working svn2cl version
    1 niro 3106 .\" Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010, 2013 Arthur de Jong
    2     .\"
    3     .\" Redistribution and use in source and binary forms, with or without
    4     .\" modification, are permitted provided that the following conditions
    5     .\" are met:
    6     .\" 1. Redistributions of source code must retain the above copyright
    7     .\" notice, this list of conditions and the following disclaimer.
    8     .\" 2. Redistributions in binary form must reproduce the above copyright
    9     .\" notice, this list of conditions and the following disclaimer in
    10     .\" the documentation and/or other materials provided with the
    11     .\" distribution.
    12     .\" 3. The name of the author may not be used to endorse or promote
    13     .\" products derived from this software without specific prior
    14     .\" written permission.
    15     .\"
    16     .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
    17     .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
    18     .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    19     .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
    20     .\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    21     .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
    22     .\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
    23     .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
    24     .\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
    25     .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
    26     .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    27     .TH "svn2cl" "1" "Oct 2010" "Version 0.14" "User Commands"
    28     .nh
    29     .SH "NAME"
    30     svn2cl - Create a ChangeLog from a subversion log.
    31     .SH "SYNOPSIS"
    32     .B svn2cl
    33     .RI [ OPTION ]...
    34     .RI [ PATH ]...
    35    
    36     .SH "DESCRIPTION"
    37     \fBsvn2cl\fP generates a classic GNU-style ChangeLog from the log messages in a subversion repository.
    38     It acts as a wrapper around the '\fBsvn log\fP' command, parsing the XML output with an XSLT stylesheet.
    39     Alternatively it can generate HTML output intended for use with the \fBsvn2html.css\fP style sheet that comes with \fBsvn2cl\fP.
    40    
    41     In addition to its own options, it accepts and passes along most svn log options; see '\fBsvn help log\fP' for a list of those and their documentation.
    42     If PATH is not given, \fBsvn2cl\fP will run svn log on the current directory, so it should do the right thing when run from the top of a subversion checkout of the project.
    43    
    44     .TP
    45     \fB\-\-strip\-prefix\fR=\fINAME\fR
    46     Strip \fINAME\fR from the first part of all file names (e.g. project/trunk).
    47     By defaults the current path inside the repository is stripped.
    48    
    49     .TP
    50     \fB\-\-linelen\fR=\fINUM\fR
    51     Wrap lines at \fINUM\fR characters.
    52     By default, lines are wrapped at 75 characters.
    53     This option is ignored when the \-\-html option is specified.
    54    
    55     .TP
    56     \fB\-\-group\-by\-day\fR
    57     This option causes all commit messages to be grouped by day, as long as all the changes are by the same author.
    58     By default each message is listed separately with its own timestamp.
    59    
    60     .TP
    61     \fB\-\-separate\-daylogs\fR
    62     Include a blank line between log entries when they are grouped by day.
    63     Only useful with the \fB\-\-group\-by\-day\fR option.
    64     This option is ignored when the \-\-html option is specified, edit \fBsvn2html.css\fP to tune the layout.
    65    
    66     .TP
    67     \fB\-i\fR, \fB\-\-include\-rev\fR
    68     Include the subversion revision number in the ChangeLog.
    69     If the \-\-html option is specified this is implied, edit \fBsvn2html.css\fP to turn it off.
    70    
    71     .TP
    72     \fB\-a\fR, \fB\-\-include\-actions\fR
    73     Add action labels [ADD], [DEL] and [CPY] tags to files to show the operation
    74     that is performned on the files.
    75    
    76     .TP
    77     \fB\-\-break\-before\-msg\fR[=\fINUM\fR]
    78     Add a line break (or multiple line breadks) between the paths and the log message.
    79     If the \-\-html option is specified this option is ignored, edit \fBsvn2html.css\fP to set spacing.
    80    
    81     .TP
    82     \fB\-\-reparagraph\fR
    83     Newlines inside paragraphs are ignored and paragraphs are re-wrapped.
    84     Paragraphs are separated by empty lines.
    85    
    86     .TP
    87     \fB\-\-title\fR=\fINAME\fR
    88     If outputting an HTML file the \fINAME\fR is used as the title.
    89     This option is ignored for normal text output.
    90    
    91     .TP
    92     \fB\-\-revision\-link\fR=\fINAME\fR
    93     This option is used to generate links from the revision numbers in the generated HTML file.
    94     If \fINAME\fR contains two hashes '\fB##\fP' that part will be replaced by the revision number, otherwise the revision number will be appended to \fINAME\fR.
    95     Only the first occurrence of '\fB##\fP' will be replaced.
    96     .br
    97     This option is ignored for normal text output.
    98    
    99     .TP
    100     \fB\-\-ticket\-link\fR=\fINAME\fR
    101     This option is used to generate links from references to tickets within the commit message in the generated HTML file.
    102     Anything that looks like a ticket reference (e.g. '\fB#foo\fP') will be replaced with a link to NAME with the ticket part ('\fBfoo\fP' in the example) appended.
    103     .br
    104     This option is ignored for normal text output.
    105    
    106     .TP
    107     \fB\-\-ticket\-prefix\fR=\fINAME\fR
    108     This option is used for finding ticket markers in the commit message (when the \fB\-\-ticket\-link\fR option is used).
    109     The default value is '\fB#\fP'.
    110     .br
    111     This option is ignored for normal text output.
    112    
    113     .TP
    114     \fB\-\-ignore\-message\-starting\fR=\fISTRING\fR
    115     Any log messages that start with the specified \fISTRING\fR are ignored and will not show up in the output.
    116     The STRING comparison is case sensitive.
    117    
    118     .TP
    119     \fB\-o\fR, \fB\-f\fR, \fB\-\-output\fR=\fIFILE\fR, \fB\-\-file\fR=\fIFILE\fR
    120     Output ChangeLog to \fIFILE\fR instead of the default \fBChangeLog\fP (or \fBChangeLog.html\fP for HTML output).
    121    
    122     .TP
    123     \fB\-\-stdout\fR
    124     Output ChangeLog to stdout instead of to a file.
    125    
    126     .TP
    127     \fB\-\-authors\fR=\fIFILE\fR
    128     The \fIFILE\fR is used to map author names as exported by svn to full names.
    129     See the section on AUTHORS FILES below for more information.
    130     .br
    131     Note that the \-\-authors option can have poor performance in some cases.
    132    
    133     .TP
    134     \fB\-\-html\fR
    135     Generate an HTML file containing a ChangeLog instead of the default text ChangeLog file.
    136     This feature is still experimental.
    137     The \fBsvn2html.css\fP file that is included in the distribution can be used to format the HTML.
    138    
    139     .TP
    140     \fB\-h\fR, \fB\-\-help\fR
    141     Show short summary of options.
    142    
    143     .TP
    144     \fB\-V\fR, \fB\-\-version\fR
    145     Show version of program.
    146    
    147     .PP
    148     Optional PATH arguments and the following options are passed directly to the '\fBsvn \-\-xml log\fP' command:
    149     \fB\-r\fR, \fB\-\-revision\fR, \fB\-\-targets\fR, \fB\-\-stop\-on\-copy\fR, \fB\-\-username\fR, \fB\-\-password\fR, \fB\-\-no\-auth\-cache\fR, \fB\-\-non\-interactive\fR, \fB\-\-config\-dir\fR and \fB\-\-limit\fR.
    150     .br
    151     See '\fBsvn help log\fP' for more information on these options.
    152    
    153     .SH "AUTHORS FILES"
    154    
    155     An authors file is basically an XML file that should look something like:
    156     .ft B
    157     <?xml version="1.0" encoding="utf\-8"?>
    158     <authors>
    159     <author uid="arthur">
    160     Arthur de Jong &lt;arthur@arthurdejong.org&gt;
    161     </author>
    162     </authors>
    163     .ft R
    164     .br
    165     svn2cl searches for <author> tags with the specified uid attribute.
    166     The content from the author tag is substituted for the author name.
    167    
    168     The <author> tag may also contain XML child tags which can be useful for embedding HTML into the result.
    169     For this to work namespace information should be included for HTML output:
    170     .ft B
    171     <?xml version="1.0" encoding="utf\-8"?>
    172     <authors xmlns:html="http://www.w3.org/1999/xhtml">
    173     <author uid="arthur">
    174     Arthur de Jong &lt;<html:b>arthur@arthurdejong.org</html:b>&gt;
    175     </author>
    176     </authors>
    177     .ft R
    178     .br
    179     The svn2cl distribution contains a sample authors.xml file.
    180    
    181     As a bonus a plain text authors file that looks like the following is automatically converted to the XML representation:
    182     .ft B
    183     arthur:Arthur de Jong <arthur@arthurdejong.org>
    184     .ft R
    185    
    186     .SH "NOTES"
    187    
    188     Note that the default revison range for \fBsvn log\fP is BASE:1.
    189     This means that \fBsvn2cl\fP will not always include the most recent revisons
    190     of the repository. Either run '\fBsvn update\fP' before running \fBsvn2cl\fP
    191     or pass '\fB\-r HEAD:1\fP'.
    192    
    193     .SH "EXAMPLES"
    194    
    195     Run svn log recursively on the current directory and generate a text ChangeLog file in the current directory for the entire log history:
    196     .ft B
    197     svn2cl
    198     .ft R
    199    
    200     Output the changes from the last week, while including revision numbers in the ChangeLog:
    201     .ft B
    202     svn2cl \-i \-r "HEAD:{`date \-d '7 days ago' '+%F %T'`}"
    203     .ft R
    204     .br
    205     (actually subversion will include the first revision before the specified period)
    206    
    207     Generate an HTML changelog for svn://svn.example.com/project/trunk, removing "project/trunk" from the file names in the changelog.
    208     Group all commits per day into one ChangeLog entry and only include changes from 2005:
    209     .ft B
    210     svn2cl \-\-html \-\-strip\-prefix=project/trunk \-\-group\-by\-day \e
    211     \-r '{2006\-01\-01}:{2005\-01\-01}' \e
    212     svn://svn.example.com/project/trunk
    213     .ft R
    214    
    215     .SH "SEE ALSO"
    216     .BR '\fBsvn\ help\ log\fP'
    217    
    218     .SH "COPYRIGHT"
    219     Copyright \(co 2005, 2006, 2007, 2008, 2009, 2010, 2013 Arthur de Jong <arthur@arthurdejong.org>.
    220     .br
    221     This is free software; see the license for copying conditions. There is NO
    222     warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.