Mercurial > hgbook
changeset 360:45ad9986748a
started template.tex
| author | Yoshiki Yazawa <yaz@honeyplanet.jp> |
|---|---|
| date | Mon, 22 Sep 2008 01:42:57 +0900 |
| parents | 81116699a510 |
| children | 96437101a088 |
| files | ja/template.tex ja/todo.txt |
| diffstat | 2 files changed, 255 insertions(+), 120 deletions(-) [+] |
line wrap: on
line diff
--- a/ja/template.tex Wed Sep 03 15:23:41 2008 +0900 +++ b/ja/template.tex Mon Sep 22 01:42:57 2008 +0900 @@ -1,158 +1,277 @@ -\chapter{Customising the output of Mercurial} +%\chapter{Customising the output of Mercurial} +\chapter{Mercurial$B$N=PNO$N%+%9%?%^%$%:(B} \label{chap:template} -Mercurial provides a powerful mechanism to let you control how it -displays information. The mechanism is based on templates. You can -use templates to generate specific output for a single command, or to -customise the entire appearance of the built-in web interface. +%Mercurial provides a powerful mechanism to let you control how it +%displays information. The mechanism is based on templates. You can +%use templates to generate specific output for a single command, or to +%customise the entire appearance of the built-in web interface. -\section{Using precanned output styles} +Mercurial$B$K$O>pJs$NI=<($r%3%s%H%m!<%k$9$k$?$a$N6/NO$J5!9=$,$"$k!%$3$N5!9=(B +$B$O%F%s%W%l!<%H$r%Y!<%9$H$7$F$$$k!%%F%s%W%l!<%H$K$h$C$F$"$k%3%^%s%I$+$iFC(B +$BJL$N=PNO$r9T$C$?$j!$FbB"$N%&%'%V%$%s%?%U%'!<%9$N8+$?L\$r%+%9%?%^%$%:$9$k(B +$B$3$H$,$G$-$k!%(B + +%\section{Using precanned output styles} +\section{$BMQ0U$5$l$?=PNO%9%?%$%k$NMxMQ(B} \label{sec:style} -Packaged with Mercurial are some output styles that you can use -immediately. A style is simply a precanned template that someone -wrote and installed somewhere that Mercurial can find. +%Packaged with Mercurial are some output styles that you can use +%immediately. A style is simply a precanned template that someone +%wrote and installed somewhere that Mercurial can find. -Before we take a look at Mercurial's bundled styles, let's review its -normal output. +$B$9$0$K;H$&$3$H$N$G$-$k$$$/$D$+$N%9%?%$%k$,(BMercurial$B$KF1:-$5$l$F$$$k!%%9%?(B +$B%$%k$H$O4L5M$5$l$?%F%s%W%l!<%H$G$"$j!$(B Mercurial$B$N%$%s%9%H!<%k$5$l$?$I$3(B +$B$+$N%^%7%s$GC/$+$,=q$$$F%$%s%9%H!<%k$7$?$b$N$G$"$k!%(B + +%Before we take a look at Mercurial's bundled styles, let's review its +%normal output. + +Mercurial$BF1:-$N%9%?%$%k$r8+$kA0$K!$DL>o$N=PNO$r8+$F$_$h$&!%(B \interaction{template.simple.normal} -This is somewhat informative, but it takes up a lot of space---five -lines of output per changeset. The \texttt{compact} style reduces -this to three lines, presented in a sparse manner. +%This is somewhat informative, but it takes up a lot of space---five +%lines of output per changeset. The \texttt{compact} style reduces +%this to three lines, presented in a sparse manner. + +$B$3$N=PNO$K$OM-1W$J>pJs$,4^$^$l$F$$$k$,!$(B1$B$D$N%A%'%s%8%;%C%HKh$K(B5$B9T$r;H$&(B +$B$J$I!$B?$/$N%9%Z!<%9$rHq$d$9!%(B\texttt{compact}$B%9%?%$%k$OAB$i$JJ}K!$r;H$&(B +$B$3$H$G$3$l$r(B3$B9T$K8:$i$9!%(B \interaction{template.simple.compact} -The \texttt{changelog} style hints at the expressive power of -Mercurial's templating engine. This style attempts to follow the GNU -Project's changelog guidelines\cite{web:changelog}. +%The \texttt{changelog} style hints at the expressive power of +%Mercurial's templating engine. This style attempts to follow the GNU +%Project's changelog guidelines\cite{web:changelog}. + +\texttt{changelog}$B%9%?%$%k$O(BMercurial$B$N%F%s%W%l!<%H%(%s%8%s$N0RNO$rCN$k$$(B +$B$$Nc$G$"$k!%$3$N%9%?%$%k$O(BGNU$B%W%m%8%'%/%H$N(Bchangelog$B%,%$%I%i%$%s(B +\cite{web:changelog}$B$K=>$*$&$H$9$k!%(B \interaction{template.simple.changelog} -You will not be shocked to learn that Mercurial's default output style -is named \texttt{default}. +%You will not be shocked to learn that Mercurial's default output style +%is named \texttt{default}. + +Mercurial$B$N%G%U%)%k%H=PNO%9%?%$%k$,(B\texttt{default}$B$HL>IU$1$i$l$F$$$k$N(B +$B$O6C$/$KCM$7$J$$!%(B -\subsection{Setting a default style} +%\subsection{Setting a default style} +\subsection{$B%G%U%)%k%H%9%?%$%k$N@_Dj(B} -You can modify the output style that Mercurial will use for every -command by editing your \hgrc\ file, naming the style you would -prefer to use. +%You can modify the output style that Mercurial will use for every +%command by editing your \hgrc file, naming the style you would +%prefer to use. + +Mercurial$B$NA4$F$N%3%^%s%I$GMQ$$$i$l$k=PNO%9%?%$%k$O(B\hgrc$B%U%!%$%k$rJT=8$9(B +$B$k$3$H$G@_Dj$G$-!$9%$-$JL>A0$rIU$1$k$3$H$,$G$-$k!%(B \begin{codesample2} [ui] style = compact \end{codesample2} -If you write a style of your own, you can use it by either providing -the path to your style file, or copying your style file into a -location where Mercurial can find it (typically the \texttt{templates} -subdirectory of your Mercurial install directory). +%If you write a style of your own, you can use it by either providing +%the path to your style file, or copying your style file into a +%location where Mercurial can find it (typically the \texttt{templates} +%subdirectory of your Mercurial install directory). + +$B<+J,$G%9%?%$%k$r=q$$$?$H$-$O!$%9%?%$%k%U%!%$%k$N%Q%9$rDI2C$7$?$j!$%U%!%$(B +$B%k$r(BMercurial$B$,H/8+$G$-$k>l=j(B($BE57?E*$K$O!$(BMercurial$B$N%$%s%9%H!<%k%G%#%l%/(B +$B%H%j$N(B\texttt{templates}$B%5%V%G%#%l%/%H%j(B)$B$K%3%T!<$9$k$3$H$GMxMQ2DG=$K$J(B +$B$k!%(B -\section{Commands that support styles and templates} +%\section{Commands that support styles and templates} +\section{$B%9%?%$%k$H%F%s%W%l!<%H$r%5%]!<%H$9$k%3%^%s%I(B} -All of Mercurial's ``\texttt{log}-like'' commands let you use styles -and templates: \hgcmd{incoming}, \hgcmd{log}, \hgcmd{outgoing}, and -\hgcmd{tip}. +%All of Mercurial's ``\texttt{log}-like'' commands let you use styles +%and templates: \hgcmd{incoming}, \hgcmd{log}, \hgcmd{outgoing}, and +%\hgcmd{tip}. + +Mercurial$B$N(B``\texttt{log}$B7O(B''$B$NA4$F$N%3%^%s%I(B: \hgcmd{incoming}, +\hgcmd{log}, \hgcmd{outgoing}, $B$*$h$S(B\hgcmd{tip}$B$O%9%?%$%k$H%F%s%W%l!<%H(B +$B$rMxMQ$7$F$$$k!%(B -As I write this manual, these are so far the only commands that -support styles and templates. Since these are the most important -commands that need customisable output, there has been little pressure -from the Mercurial user community to add style and template support to -other commands. +%As I write this manual, these are so far the only commands that +%support styles and templates. Since these are the most important +%commands that need customisable output, there has been little pressure +%from the Mercurial user community to add style and template support to +%other commands. + +$B$3$N%^%K%e%"%k$G=q$$$F$$$k$h$&$K!$$3$l$^$G$N$H$3$m!$$3$l$i$N%3%^%s%I$@$1(B +$B$,%9%?%$%k$H%F%s%W%l!<%H$r%5%]!<%H$7$F$$$k!%$3$l$i$,%+%9%?%^%$%:2DG=$J=P(B +$BNO$,I,MW$J:G$b=EMW$J%3%^%s%I$G$"$k$?$a!$(B Mercurial$B$N%f!<%6%3%_%e%K%F%#$+(B +$B$iB>$N%3%^%s%I$K%9%?%$%k$H%F%s%W%l!<%H%5%]!<%H$rE,MQ$+$N$&$K$;$h$H$$$&%W(B +$B%l%C%7%c!<$O$[$H$s$I$J$$!%(B -\section{The basics of templating} +%\section{The basics of templating} +\section{$B%F%s%W%l!<%H$N4pK\(B} + +%At its simplest, a Mercurial template is a piece of text. Some of the +%text never changes, while other parts are \emph{expanded}, or replaced +%with new text, when necessary. -At its simplest, a Mercurial template is a piece of text. Some of the -text never changes, while other parts are \emph{expanded}, or replaced -with new text, when necessary. +$B:G$bC1=c$J(BMercurial$B%F%s%W%l!<%H$O%F%-%9%HJR$G$"$k!%%F%-%9%H$N$"$kItJ,$OIT(B +$BJQ$G!$B>$NItJ,$OI,MW$K1~$8$F(B\emph{$BE83+(B}$B$5$l$k$?$j?7$7$$%F%-%9%H$KCV49$5$l(B +$B$k!%(B -Before we continue, let's look again at a simple example of -Mercurial's normal output. +%Before we continue, let's look again at a simple example of +%Mercurial's normal output. + +$B$5$i$KB3$1$kA0$K(BMercurial$BI8=`=PNO$NNc$r$b$&0lEY8+$F$_$h$&!%(B \interaction{template.simple.normal} -Now, let's run the same command, but using a template to change its -output. +%Now, let's run the same command, but using a template to change its +%output. + +$B$3$3$GF1$8%3%^%s%I$r=PNO$rJQ2=$5$;$k$?$a$K%F%s%W%l!<%H$r;H$C$F$_$h$&!%(B \interaction{template.simple.simplest} -The example above illustrates the simplest possible template; it's -just a piece of static text, printed once for each changeset. The -\hgopt{log}{--template} option to the \hgcmd{log} command tells -Mercurial to use the given text as the template when printing each -changeset. +%The example above illustrates the simplest possible template; it's +%just a piece of static text, printed once for each changeset. The +%\hgopt{log}{--template} option to the \hgcmd{log} command tells +%Mercurial to use the given text as the template when printing each +%changeset. + +$B>e$NNc$O:G$bC1=c$J%F%s%W%l!<%H$r<($7$?(B; $B@EE*$J%F%-%9%H$@$1$+$i$J$j!$3F%A%'(B +$B%s%8%;%C%H$K$D$$$F0lEY$@$1=PNO$r9T$&!%(B\hgcmd{log}$B%3%^%s%I$K(B +\hgopt{log}{--template}$B%*%W%7%g%s$r;H$&$H(BMercurial$B$O3F!9$N%A%'%s%8%;%C%H(B +$B$r=PNO$9$k$H$-$K!$M?$($i$l$?%F%-%9%H$r%F%s%W%l!<%H$H$7$FMQ$$$k!%(B -Notice that the template string above ends with the text -``\Verb+\n+''. This is an \emph{escape sequence}, telling Mercurial -to print a newline at the end of each template item. If you omit this -newline, Mercurial will run each piece of output together. See -section~\ref{sec:template:escape} for more details of escape sequences. +%Notice that the template string above ends with the text +%``\Verb+\n+''. This is an \emph{escape sequence}, telling Mercurial +%to print a newline at the end of each template item. If you omit this +%newline, Mercurial will run each piece of output together. See +%section~\ref{sec:template:escape} for more details of escape sequences. -A template that prints a fixed string of text all the time isn't very -useful; let's try something a bit more complex. +$B%F%s%W%l!<%HJ8;zNs$O(B``\Verb+\n+''$B$G=*$k$3$H$KCm0U!%$3$l$O(BMercurial$B$K%F%s(B +$B%W%l!<%H$N3FMWAG$NKvHx$K2~9T$r=PNO$9$k$h$&;X<($9$k(B\emph{$B%(%9%1!<%W%7!<%1(B +$B%s%9(B}$B$G$"$k!%$3$N2~9T$r>JN,$9$k$H(BMercurial$B$O3FMWAG$r7R$2$F=PNO$9$k!%%(%9(B +$B%1!<%W%7!<%1%s%9$N$h$j>\:Y$J@bL@$K$D$$$F$O(B~\ref{sec:template:escape}$B@a$r(B +$B;2>H$N$3$H!%(B + +%A template that prints a fixed string of text all the time isn't very +%useful; let's try something a bit more complex. + +$B>o$K8GDjJ8;zNs$r=PNO$9$k%F%s%W%l!<%H$O$"$^$jM-MQ$G$"$k$H$O8@$($J$$!%$b$&(B +$B>/$79~$_F~$C$?%F%s%W%l!<%H$r;n$=$&!%(B \interaction{template.simple.simplesub} -As you can see, the string ``\Verb+{desc}+'' in the template has been -replaced in the output with the description of each changeset. Every -time Mercurial finds text enclosed in curly braces (``\texttt{\{}'' -and ``\texttt{\}}''), it will try to replace the braces and text with -the expansion of whatever is inside. To print a literal curly brace, -you must escape it, as described in section~\ref{sec:template:escape}. +%As you can see, the string ``\Verb+{desc}+'' in the template has been +%replaced in the output with the description of each changeset. Every +%time Mercurial finds text enclosed in curly braces (``\texttt{\{}'' +%and ``\texttt{\}}''), it will try to replace the braces and text with +%the expansion of whatever is inside. To print a literal curly brace, +%you must escape it, as described in section~\ref{sec:template:escape}. -\section{Common template keywords} +$B%F%s%W%l!<%HFb$N(B``\Verb+{desc}+''$B$H$$$&J8;zNs$O=PNO$G$O!$3F!9$N%A%'%s%8%;%C(B +$B%H$N@bL@$KCV49$5$l$k!%(BMercurial$B$OCf3g8L(B(``\texttt{\{}''$B$H(B +``\texttt{\}}'')$B$G0O$^$l$?%F%-%9%H$r8+$D$1$k$HCf3g8L$H%F%-%9%H$rFbIt$N%F(B +$B%-%9%H$rE83+$7$?$b$N$KCV49$7$h$&$H;n$_$k!%J8;z$H$7$FCf3g8L$r0u;z$7$?$$>l(B +$B9g$O(B~\ref{sec:template:escape}$B@a$G<($9$h$&$K%(%9%1!<%W$9$kI,MW$,$"$k!%(B + +%\section{Common template keywords} +\section{$B%F%s%W%l!<%H$N6&DL%-!<%o!<%I(B} \label{sec:template:keyword} -You can start writing simple templates immediately using the keywords -below. +%You can start writing simple templates immediately using the keywords +%below. + +$BC1=c$J%F%s%W%l!<%H$O0J2<$N$h$&$J%-!<%o!<%I$r;H$C$FD>$A$K=q$/$3$H$,$G$-$k!%(B \begin{itemize} -\item[\tplkword{author}] String. The unmodified author of the changeset. -\item[\tplkword{branches}] String. The name of the branch on which - the changeset was committed. Will be empty if the branch name was - \texttt{default}. -\item[\tplkword{date}] Date information. The date when the changeset - was committed. This is \emph{not} human-readable; you must pass it - through a filter that will render it appropriately. See - section~\ref{sec:template:filter} for more information on filters. - The date is expressed as a pair of numbers. The first number is a - Unix UTC timestamp (seconds since January 1, 1970); the second is - the offset of the committer's timezone from UTC, in seconds. -\item[\tplkword{desc}] String. The text of the changeset description. -\item[\tplkword{files}] List of strings. All files modified, added, or - removed by this changeset. -\item[\tplkword{file\_adds}] List of strings. Files added by this - changeset. -\item[\tplkword{file\_dels}] List of strings. Files removed by this - changeset. -\item[\tplkword{node}] String. The changeset identification hash, as a - 40-character hexadecimal string. -\item[\tplkword{parents}] List of strings. The parents of the - changeset. -\item[\tplkword{rev}] Integer. The repository-local changeset revision - number. -\item[\tplkword{tags}] List of strings. Any tags associated with the - changeset. +%\item[\tplkword{author}] String. The unmodified author of the changeset. +\item[\tplkword{author}] $BJ8;zNs!%%A%'%s%8%;%C%H$NCx<T$,$=$N$b$N!%(B +%\item[\tplkword{branches}] String. The name of the branch on which +% the changeset was committed. Will be empty if the branch name was +% \texttt{default}. +\item[\tplkword{branches}] $BJ8;zNs!%%A%'%s%8%;%C%H$,%3%_%C%H$5$l$?%V%i%s(B + $B%A$NL>A0!%%V%i%s%AL>$,(B\texttt{default}$B$N>l9g$O(B + $B6uMs$H$J$k!%(B +%\item[\tplkword{date}] Date information. The date when the changeset +% was committed. This is \emph{not} human-readable; you must pass it +% through a filter that will render it appropriately. See +% section~\ref{sec:template:filter} for more information on filters. +% The date is expressed as a pair of numbers. The first number is a +% Unix UTC timestamp (seconds since January 1, 1970); the second is +% the offset of the committer's timezone from UTC, in seconds. +\item[\tplkword{date}] $BF|;~>pJs!%%A%'%s%8%;%C%H$,%3%_%C%H$5$l$?F|;~!%$3$l(B + $B$O?M4V$N2DFI$J7A<0$G$O(B\emph{$B$J$$(B}$B!%I,$:E,@Z$J%U%#(B + $B%k%?$r8F$S=P$7$FJQ49$9$kI,MW$,$"$k!%%U%#%k%?$K4X(B + $B$9$k$h$j>\:Y$J@bL@$O(B~\ref{sec:template:filter} + $B@a$r;2>H$N$3$H!%F|;~$O(B2$B$D$N?t;z$NAH$_9g$o$;$GI=(B + $B$5$l$k!%:G=i$N?t;z$O(BUTC$B$G$N(BUnix$B%?%$%`%9%?%s%W(B + (1970$BG/(B1$B7n(B1$BF|$+$i$NIC?t(B)$B$G!$(B2$BHVL\$N?t;z$O%3%_%C(B + $B%?$N%?%$%`%>!<%s$N(BUTC$B$+$i$N;~:9$rIC?t$GI=$7$?$b(B + $B$N$G$"$k!%(B +%\item[\tplkword{desc}] String. The text of the changeset description. +\item[\tplkword{desc}] $BJ8;zNs!%%A%'%s%8%;%C%H$N@bL@J8!%(B + +%\item[\tplkword{files}] List of strings. All files modified, added, or +% removed by this changeset. +\item[\tplkword{files}] $BJ8;zNs$N%j%9%H!%$3$N%A%'%s%8%;%C%H$GJQ99!$DI2C!$(B + $B:o=|$5$l$?A4$F$N%U%!%$%k$NL>A0!%(B + +%\item[\tplkword{file\_adds}] List of strings. Files added by this +% changeset. +\item[\tplkword{file\_adds}] $BJ8;zNs$N%j%9%H!%$3$N%A%'%s%8%;%C%H$GDI2C$5(B + $B$l$?%U%!%$%k$NL>A0!%(B + +%\item[\tplkword{file\_dels}] List of strings. Files removed by this +% changeset. +\item[\tplkword{file\_dels}] $BJ8;zNs$N%j%9%H!%$3$N%A%'%s%8%;%C%H$G:o=|$5(B + $B$l$?%U%!%$%k$NL>A0!%(B + +%\item[\tplkword{node}] String. The changeset identification hash, as a +% 40-character hexadecimal string. +\item[\tplkword{node}] $BJ8;zNs!%%A%'%s%8%;%C%H$N<1JL%O%C%7%e$r(B40$BJ8;z$N(B16 + $B?J?t$G<($7$?$b$N!%(B + +%\item[\tplkword{parents}] List of strings. The parents of the +% changeset. +\item[\tplkword{parents}] $BJ8;zNs$N%j%9%H!%%A%'%s%8%;%C%H$N?F!%(B + +%\item[\tplkword{rev}] Integer. The repository-local changeset revision +% number. +\item[\tplkword{rev}] $B@0?t!%%j%]%8%H%j%m!<%+%k$N%A%'%s%8%;%C%H%j%S%8%g%s(B + $BHV9f!%(B + +%\item[\tplkword{tags}] List of strings. Any tags associated with the +% changeset. +\item[\tplkword{tags}] $BJ8;zNs$N%j%9%H!%%A%'%s%8%;%C%H$K4XO"$E$1$i$l$?G$(B + $B0U$N%?%0!%(B \end{itemize} -A few simple experiments will show us what to expect when we use these -keywords; you can see the results in -figure~\ref{fig:template:keywords}. +%A few simple experiments will show us what to expect when we use these +%keywords; you can see the results in +%figure~\ref{fig:template:keywords}. + +$B$$$/$D$+;n$7$F$_$l$P$3$l$i$N%-!<%o!<%I$K$I$N$h$&$J8z2L$,$"$k$N$+$rCN$k$3(B +$B$H$,$G$-$k!%7k2L$r?^(B~\ref{fig:template:keywords}$B$K<($9!%(B \begin{figure} \interaction{template.simple.keywords} - \caption{Template keywords in use} +% \caption{Template keywords in use} + \caption{$B%F%s%W%l!<%H%-!<%o!<%I$N;HMQ(B} \label{fig:template:keywords} \end{figure} -As we noted above, the date keyword does not produce human-readable -output, so we must treat it specially. This involves using a -\emph{filter}, about which more in section~\ref{sec:template:filter}. +%As we noted above, the date keyword does not produce human-readable +%output, so we must treat it specially. This involves using a +%\emph{filter}, about which more in section~\ref{sec:template:filter}. + +$B4{$K=R$Y$?$h$&$K!$(Bdate$B%-!<%o!<%I$O2DFI$J=PNO$r9T$o$J$$$?$a!$FCJL$J<h$j07(B +$B$$$,I,MW$G$"$k!%$=$NL\E*$G(B\emph{filter}$B$r;HMQ$9$k$,!$$h$j>\:Y$K(B +$B$O(B~\ref{sec:template:filter}$B@a$G<h$j07$&!%(B \interaction{template.simple.datekeyword} -\section{Escape sequences} +%\section{Escape sequences} +\section{$B%(%9%1!<%W%7!<%1%s%9(B} \label{sec:template:escape} Mercurial's templating engine recognises the most commonly used escape @@ -175,7 +294,8 @@ a literal ``\Verb+\+'', ``\Verb+{+'', or ``\Verb+{+'' character, you must escape it. -\section{Filtering keywords to change their results} +%\section{Filtering keywords to change their results} +\section{$B7k2L$r2~JQ$9$k%U%#%k%?%-!<%o!<%I(B} \label{sec:template:filter} Some of the results of template expansion are not immediately easy to @@ -275,7 +395,8 @@ into the \tplkwfilt{date}{isodate} filter is not a good idea. \end{note} -\subsection{Combining filters} +%\subsection{Combining filters} +\subsection{$BAH$_9g$o$;%U%#%k%?(B} It is easy to combine filters to yield output in the form you would like. The following chain of filters tidies up a description, then @@ -296,7 +417,8 @@ \Verb+tabindent|fill68+. -\section{From templates to styles} +%\section{From templates to styles} +\section{$B%F%s%W%l!<%H$+$i%9%?%$%k$X(B} A command line template provides a quick and simple way to format some output. Templates can become verbose, though, and it's useful to be @@ -307,7 +429,8 @@ templating engine in ways that are not possible using the command line \hgopt{log}{--template} option. -\subsection{The simplest of style files} +%\subsection{The simplest of style files} +\subsection{$B:G$bC1=c$J%9%?%$%k%U%!%$%k(B} Our simple style file contains just one line: @@ -316,7 +439,8 @@ This tells Mercurial, ``if you're printing a changeset, use the text on the right as the template''. -\subsection{Style file syntax} +%\subsection{Style file syntax} +\subsection{$B%9%?%$%k%U%!%$%k$NJ8K!(B} The syntax rules for a style file are simple. @@ -348,7 +472,8 @@ file will be read and used as a template body. \end{itemize} -\section{Style files by example} +%\section{Style files by example} +\section{$B%9%?%$%k%U%!%$%k$NNc(B} To illustrate how to write a style file, we will construct a few by example. Rather than provide a complete style file and walk through @@ -356,7 +481,8 @@ starting with something very simple, and walking through a series of successively more complete examples. -\subsection{Identifying mistakes in style files} +%\subsection{Identifying mistakes in style files} +\subsection{$B%9%?%$%k%U%!%$%k$G$N8m$j$rFCDj$9$k(B} If Mercurial encounters a problem in a style file you are working on, it prints a terse error message that, once you figure out what it @@ -401,7 +527,8 @@ is wrong. \end{itemize} -\subsection{Uniquely identifying a repository} +%\subsection{Uniquely identifying a repository} +\subsection{$B%j%]%8%H%j$NFCDj(B} If you would like to be able to identify a Mercurial repository ``fairly uniquely'' using a short string as an identifier, you can @@ -425,20 +552,28 @@ activity, so that you can ``replay'' the build later if necessary. \end{itemize} -\subsection{Mimicking Subversion's output} +%\subsection{Mimicking Subversion's output} +\subsection{Subversion$B=PNO$NLOJo(B} -Let's try to emulate the default output format used by another -revision control tool, Subversion. +%Let's try to emulate the default output format used by another +%revision control tool, Subversion. +%\interaction{template.svnstyle.short} + +$BJL$N%P!<%8%g%s4IM}%D!<%k$G$"$k(BSubversion$B$N=PNO$r%(%_%e%l!<%H$7$F$_$h$&!%(B \interaction{template.svnstyle.short} -Since Subversion's output style is fairly simple, it is easy to -copy-and-paste a hunk of its output into a file, and replace the text -produced above by Subversion with the template values we'd like to see -expanded. -\interaction{template.svnstyle.template} +%Since Subversion's output style is fairly simple, it is easy to +%copy-and-paste a hunk of its output into a file, and replace the text +%produced above by Subversion with the template values we'd like to see +%expanded. -There are a few small ways in which this template deviates from the -output produced by Subversion. +Subversion$B$N=PNO%9%?%$%k$O$+$J$jC1=c$J$N$G!$=PNO$+$i%U%!%$%k$X(Bhunk$B$r%3%T!<(B +$B!u%Z!<%9%H$7!$(BSubversion$B$,@8@.$7$?%F%-%9%H$r%F%s%W%l!<%H$K$h$C$FCV49$9$k(B +$B$N$O4JC1$G$"$k!%(B \interaction{template.svnstyle.template} + +%There are a few small ways in which this template deviates from the +%output produced by Subversion. + \begin{itemize} \item Subversion prints a ``readable'' date (the ``\texttt{Wed, 27 Sep 2006}'' in the example output above) in parentheses. Mercurial's @@ -469,7 +604,7 @@ big or cluttered if you insert a literal piece of text, drop it into a template instead. -%%% Local Variables: +%%% Local Variables: %%% mode: yatex %%% TeX-master: "00book" -%%% End: +%%% End: