aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas White <taw@bitwiz.org.uk>2010-12-02 20:20:22 +0100
committerThomas White <taw@physics.org>2012-02-22 15:27:07 +0100
commit4560e69b51b9e517bc5c7edbb80bc567f5bae2fd (patch)
tree53b2f770aa1a8826aa343dbd820722db966eafa5
parent27d14f0b1391bbc6d667eb9c82e78c3b02052e5a (diff)
Update fussiness
-rw-r--r--README18
1 files changed, 11 insertions, 7 deletions
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.