[svnbook] r4374 committed - * en/book/ch05-repository-admin.xml...
C. Michael Pilato
cmpilato at red-bean.com
Fri Feb 1 10:26:42 CST 2013
On 01/30/2013 09:59 AM, Daniel Shahaf wrote:
> C. Michael Pilato wrote on Wed, Jan 30, 2013 at 09:46:40 -0500:
>> On 01/30/2013 09:22 AM, Daniel Shahaf wrote:
>>> svnbook at googlecode.com wrote on Tue, Jan 29, 2013 at 18:50:51 +0000:
>>>> <term>format</term>
>>>> <listitem>
>>>> - <para>A file that contains a single integer that
>>>> - indicates the version number of the repository layout</para>
>>>> + <para>A file that describes the repository's internal
>>>> + organizational scheme</para>
>>> Can you mention here that this is not db/format ?
>>>
>>> It doesn't seem to be already mentioned:
>>> % grep '[>/]format<' *
>>> ch05-repository-admin.xml: <term>format</term>
>> Yeah, it's not mentioned because the book doesn't describe the internals of
>> the db/ directory. Why do you feel that this "format" vs. "db/format"
>> distinction needs to be made?
> Because there is repeated user confusion:
>
> "What does the $REPOS_DIR/db/format file contain?"
> "5"
> "No, not that 'format' file, the other one in the subdir"
> (relying on the fortunate fact that neither FSFS nor BDB ever released a format 5)
>
> I also filed a milestone-2.0 issue to rename *both* format and db/format
> (to repos-format and db/fsfs-format, for example), to avoid the chance
> for confusion.
r4384 adds your suggested-in-IRC text, more or less. Thanks!
More information about the svnbook-dev
mailing list