From 4560e69b51b9e517bc5c7edbb80bc567f5bae2fd Mon Sep 17 00:00:00 2001 From: Thomas White Date: Thu, 2 Dec 2010 20:20:22 +0100 Subject: Update fussiness --- README | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) (limited to 'README') diff --git a/README b/README index 47cff040..a2848962 100644 --- a/README +++ b/README @@ -109,22 +109,26 @@ $ ./configure --disable-gtk --disable-png --disable-libtiff Program name ------------ -There seems to be a tendency to capitalise the names of programs in -publications. It's not 1970 any more, and programs can have capitalisation -any way we choose, not just all capitals. I hope you can forgive me for being -fussy about how my work is referred to in publications and talks. +There seems to be a tendency to capitalise all the letters in the names of +programs in scientific publications. It's not 1970 any more, and programs can +have capitalisation any way we choose, not just all capitals. The name for the overall software suite is "CrystFEL", with this being the only acceptable capitalisation. The individual programs should always be referred to -with all letters in lower case, exactly as written earlier in this file. Put -the names in quotes if they sound strange to you. +with all letters in lower case, exactly the same as the names of the binaries. +Put the names in quotes if this sounds strange to you. The only exception is if +the name of the program comes at the start of a sentence, or in a title, or +similar position where a word would normally be capitalised. In most cases, it will be more appropriate to refer to the overall suite than to one of its constituent programs. The following are NOT acceptable forms: "CRYSTFEL", "crystFEL", "Crystfel", -"Indexamajig", "INDEXAMAJIG", "PATTERN_SIM", "Pattern_Sim", "Pattern_sim". +"INDEXAMAJIG", "PATTERN_SIM", "Pattern_Sim" and "Pattern_sim". In addition, CrystFEL is made up of "programs", not "routines" nor "procedures". (The "programs" in turn are made up from "routines" and "procedures", but unless you are exploring the source code, there's no need for you to know about that). + +I hope you can forgive me for being fussy about how my work is referred to in +publications and talks. -- cgit v1.2.3