On 11/17/05, Julian Foad <julianfoad@btopenworld.com> wrote:
> Erik Huelsmann wrote:
> > On 11/15/05, Malcolm Rowe <malcolm@farside.org.uk> wrote:
> >
> >>>+ /** Translate from Normal Format; excludes SVN_WC_TRANSLATE_TO_NF */
> >>>+#define SVN_WC_TRANSLATE_FROM_NF 0x00000000
> >>>+
> >>>+ /** Translate to Normal Format; excludes SVN_WC_TRANSLATE_FROM_NF */
> >>>+#define SVN_WC_TRANSLATE_TO_NF 0x00000001
> >>
> >>What is 'Normal Form(at)'?
> >
> > Well, the essence of my changes are actually to keep that an
> > implementation detail. The user of these constants should not have to
> > know what it is.
>
> I think Malcolm probably meant (or at least it would be reasonable to ask) not
> "What are the exact details of Normal Format", but "What is the fundamental
> definition of Normal Format", so the answer would be something like:
Yes, I'm adding it to my followup commit to at least fix these errors
- whatever we decide to do with the function in the end.
> "Normal Format of a given file is the format in which the file is stored in
> the repository and as the pristine copy of its base revision in the working
> copy. [...Details about why it is used and how it can differ from the working
> copy...]"
>
> I agree with your comment that such information should be somewhere like in a
> libsvn_wc documentation file.
Since it's more of a system wide issue (not libsvn_wc only), I think
I'll need to write a document for notes/ and refer to that.
bye,
Erik.
Received on Thu Nov 17 22:09:09 2005