Bookmark and Share

Notice: On March 31, it was announced that Statalist is moving from an email list to a forum. The old list will shut down at the end of May, and its replacement, statalist.org is already up and running.


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

st: -cmdname- convention commended concisely


From   Nick Cox <n.j.cox@durham.ac.uk>
To   "'statalist@hsphsun2.harvard.edu'" <statalist@hsphsun2.harvard.edu>
Subject   st: -cmdname- convention commended concisely
Date   Tue, 13 Mar 2012 10:55:33 +0000

I'd like to draw many members' attention to the -cmdname- convention that is commended in the Statalist FAQ and used routinely by most of the more active or experienced members of the list. 

It's simply this: use - - to indicate Stata syntax that might be typed. 

This is not needed, and indeed a distraction, for blocks of code that are displayed separately within postings. But it often helps flag your code references that are embedded in text discussion.

Of many examples that could be cited, one very recent thread flitted back and forth between discussing the -syntax- command and Stata's command syntax. See how the - - help clarify what is being referred to? 

Of course, some people may prefer their own convention, such as using "syntax" but that in turn can easily be awkward because of numerous other ways that quotation marks might be used. 

One convention that must be declared poor is using caps such as SYNTAX. This is not at all Stataish, partly because it does not correspond to anything you might type and partly because it creates among many people a synaesthetic reaction that you are SHOUTING, which is not a good idea. 

As said, this is a convention not a rule, but it is a good one (or more precisely a Gould one). 

Nick 
n.j.cox@durham.ac.uk 



*
*   For searches and help try:
*   http://www.stata.com/help.cgi?search
*   http://www.stata.com/support/statalist/faq
*   http://www.ats.ucla.edu/stat/stata/


© Copyright 1996–2014 StataCorp LP   |   Terms of use   |   Privacy   |   Contact us   |   Site index