hgbook on bitbucket; was: hgbook is broken?

Marcin Kasperski Marcin.Kasperski at mekk.waw.pl
Fri Feb 13 06:50:47 CST 2009


Matt Mackall <mpm at selenic.com> writes:
> I also don't think it (or reST) is up to the demands of making a
> well-typeset book with lots of pretty pictures and diagrams of the kind
> a major publisher would put in bookstores. And that's what we're aiming
> for, folks.

I wouldn't exclude ReST so easily. It let's you convert to LaTeX for final
formatting, and you can embed dedicated "output-aware" fragments (specific
fragments for html, specific fragments for latex) in those rare 
places where you really need to fine-tune.

And the difference for the writer *is* big. Just compare the examples
below. Which one would you like to see edit in your editor most?

------------------- LaTeX -----------------------------------

\subsection{Removing a file does not affect its history}

It is important to understand that removing a file has only two
effects.
\begin{itemize}
\item It removes the current version of the file from the working
  directory.
\item It stops Mercurial from tracking changes to the file, from the
  time of the next commit.
\end{itemize}
Removing a file \emph{does not} in any way alter the \emph{history} of
the file.

-------------------------------------------------------------


------------------- ReST ------------------------------------

Removing a file does not affect its history
===========================================

It is important to understand that removing a file has only two
effects.

- It removes the current version of the file from the working
  directory.
- It stops Mercurial from tracking changes to the file, from the
  time of the next commit.

Removing a file *does not* in any way alter the *history* of
the file.

-------------------------------------------------------------


------------------- DocBook ---------------------------------

<sect1>

<title>Removing a file does not affect its history</title>

<para>
It is important to understand that removing a file has only two
effects.
</para>

<itemizedlist mark="bullet" spacing="normal">
<listitem>
<simplepara>It removes the current version of the file from the working
  directory.</simplepara>
</listitem>
<listitem>
<simplepara>It stops Mercurial from tracking changes to the file, from the
  time of the next commit.</simplepara>
</listitem>
</itemizedlist>

<para>
Removing a file <emphasis>does not</emphasis> in any way alter the
<emphasis>history</emphasis> of the file.
</para>

</sect1>

-------------------------------------------------------------











-- 
----------------------------------------------------------------------
| Marcin Kasperski   |  A reusable framework that is developed by
| http://mekk.waw.pl | itself will probably not be very reusable.
|                    |                  (Martin)
----------------------------------------------------------------------



More information about the Mercurial mailing list