: Re: How do I avoid using punctuation inside quotation marks in technical writing? As a computer programmer, I comment my code. For example: The following lines are dependent on "source 1" and

@Ravi5107385

Vote Up Vote Down

You might want to take a look at BNF, Backus-Naur form as a way to describe language elements and syntax. It's unambiguous and has been in use for a long time.You would use something like <source 1> and <source 2>.

This is a calling sequence definition from one of my bash scripts:

## kmprb ##
## Usage: kmprb [-ps <num>] [-1 [-rt]] ##
## [-b <num> | -B ] ##
## [ <file> ... ] ##
## -ps <num> override default print strategy ##
## with strategy <num> ##
## ##
## -1 call kmprb_one to print all 1 page jobs ##
## first ##
## ##
## -rt reformat text files before printing ##
## ##
## -b - break printing into batchs of no more ##
## than <num> sheets ##
## ##
## -B - same as -b, but get <num> interactively ##
## ##
## If -1 is specified, kmprb_one is called ##
## to allow the user to print all 1 page jobs ##
## first. -rt will be passed to kmprb_one to ##
## reformat text files with dprint ##
## ##
## If <file> ... is specified, then just those ##
## files (from the print queue) are offered for ##
## printing ##
## Otherwise, all files in the print queue are ##
## offered ##

(0)

Login to post a comment!