Re: Patch to document base64 encoding

Hello Karl,

>> It really works in research papers: "Theorem X can be proven by
>> applying Proposition Y. See Figure 2 for details. Algorithm Z
>> describes whatever, which is listed in Table W..."
>
> I've not thought about it before but I suppose the difference is between
> declarative and descriptive, the latter being more inviting and better
> allows for flow between sentences. Otherwise you're writing in bullet
> points. So it is a question of balance between specification and
> narration. In regular prose you're always going to see the "the" unless
> the sentence starts with the name. The trouble is that we can't start
> sentences with function names because of capitalization confusion.

Sure. For me "Function" would work as a title on its name, as in "Sir
Samuel", "Doctor Frankenstein", "Mister Bean", "Professor Layton"...
"Function sqrt" and solves the casing issue on the function name which is
better not capitalized.

--
Fabien.