🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: gnu.misc.discuss
Article #2100

Why backquotes in GNU documentation?

#2100
From: Dave
Date: Tue, 08 Feb 2011 07:31
42 lines
2565 bytes
[Not sure which newsgroup would be best, sorry for the spam.]

Hi,

I have often seen single backquotes in GNU software documentation. For
example, in http://www.gnu.org/software/libc/manual/html_mono/libc.html
one can read:

	Using `htonl' is necessary so that

or:

	followed by lower-case `a'

Error messages printed by GNU software also often contain single
backquotes. For example, in commands.c of GNU make 3.82:

	    error (NILF, _("*** [%s] Archive member `%s' may be bogus; not
deleted"),
		   on_behalf_of, file->name);

Source code comments also have single backquotes. For example, in
commands.c of GNU make 3.82:

  /* If the target is an archive member `lib(member)',
     then $@ is `lib' and $% is `member'.  */

And even in the title of http://www.gnu.org/software/make/manual/make.html:

	GNU `make'

Now, I was wondering what could be the reason behind this convention.
Why not use just straight quotes also in front of the quoted word? For
example:

	Using 'htonl' is necessary so that

or:

	Using "htonl" is necessary so that

-- dave
Technical Details
Message-ID: <1996c09a-e78e-4f10-897e-2e96ea187523@a28g2000vbo.googlegroups.com>
Path: arc1-ca.pugleaf.net!g2news1.google.com!postnews.google.com!a28g2000vbo.googlegroups.com!not-for-mail

Show Full Headers
Complete Article Headers
X-Google-Thread: 1025b4,3ce2dfa9db6cde60,start
X-Google-NewGroupId: yes
X-Google-Thread: 1054c0,3ce2dfa9db6cde60,start
X-Google-NewGroupId: yes
X-Google-Thread: 11318c,3ce2dfa9db6cde60,start
X-Google-NewGroupId: yes
X-Google-Thread: 109f73,3ce2dfa9db6cde60,start
X-Google-NewGroupId: yes
X-Google-Attributes: gidfeffdbf771,gid4d82dd0a1,gid1200bcf240,gidc4b9fb5774,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII-7-bit
Path: arc1-ca.pugleaf.net!g2news1.google.com!postnews.google.com!a28g2000vbo.googlegroups.com!not-for-mail
From: Dave <dave_140390@hotmail.com>
Newsgroups: gnu.misc.discuss,gnu.bash,gnu.gcc.help,gnu.utils.help
Subject: Why backquotes in GNU documentation?
Date: Mon, 7 Feb 2011 23:31:54 -0800 (PST)
Organization: http://groups.google.com
Lines: 42
Message-ID: <1996c09a-e78e-4f10-897e-2e96ea187523@a28g2000vbo.googlegroups.com>
NNTP-Posting-Host: 193.110.109.30
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
X-Trace: posting.google.com 1297150314 28200 127.0.0.1 (8 Feb 2011 07:31:54 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Tue, 8 Feb 2011 07:31:54 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: a28g2000vbo.googlegroups.com; posting-host=193.110.109.30; posting-account=wWozmAkAAACPw4M9TY-CecJbjjctZmlB
User-Agent: G2/1.0
X-HTTP-UserAgent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.13)
 Gecko/20101211 Firefox/3.6.13 ( .NET CLR 3.5.30729),gzip(gfe)