[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/trunk r107768: Markup fixes for auth.texi
From: |
Glenn Morris |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/trunk r107768: Markup fixes for auth.texi |
Date: |
Wed, 04 Apr 2012 16:44:56 -0400 |
User-agent: |
Bazaar (2.3.1) |
------------------------------------------------------------
revno: 107768
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Wed 2012-04-04 16:44:56 -0400
message:
Markup fixes for auth.texi
* doc/misc/auth.texi (Help for users, Help for developers)
(GnuPG and EasyPG Assistant Configuration): Markup fixes.
modified:
doc/misc/ChangeLog
doc/misc/auth.texi
=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog 2012-04-04 20:36:33 +0000
+++ b/doc/misc/ChangeLog 2012-04-04 20:44:56 +0000
@@ -2,6 +2,8 @@
* auth.texi (Secret Service API): Copyedits.
(Help for developers): Fill in some missing function doc-strings.
+ (Help for users, Help for developers)
+ (GnuPG and EasyPG Assistant Configuration): Markup fixes.
2012-04-04 Michael Albinus <address@hidden>
=== modified file 'doc/misc/auth.texi'
--- a/doc/misc/auth.texi 2012-04-04 20:36:33 +0000
+++ b/doc/misc/auth.texi 2012-04-04 20:44:56 +0000
@@ -113,7 +113,7 @@
Spaces are always OK as far as auth-source is concerned (but other
programs may not like them). Just put the data in quotes, escaping
-quotes as you'd expect with @code{\}.
+quotes as you'd expect with @samp{\}.
All these are optional. You could just say (but we don't recommend
it, we're just showing that it's possible)
@@ -125,14 +125,14 @@
to use the same password everywhere. Again, @emph{DO NOT DO THIS} or
you will be pwned as the kids say.
-``Netrc'' files are usually called @code{.authinfo} or @code{.netrc};
-nowadays @code{.authinfo} seems to be more popular and the auth-source
+``Netrc'' files are usually called @file{.authinfo} or @file{.netrc};
+nowadays @file{.authinfo} seems to be more popular and the auth-source
library encourages this confusion by accepting both, as you'll see
later.
If you have problems with the search, set @code{auth-source-debug} to
@code{'trivia} and see what host, port, and user the library is
-checking in the @code{*Messages*} buffer. Ditto for any other
+checking in the @samp{*Messages*} buffer. Ditto for any other
problems, your first step is always to see what's being checked. The
second step, of course, is to write a blog entry about it and wait for
the answer in the comments.
@@ -181,11 +181,11 @@
If you don't customize @code{auth-sources}, you'll have to live with
the defaults: any host and any port are looked up in the netrc
-file @code{~/.authinfo.gpg}, which is a GnuPG encrypted file
+file @file{~/.authinfo.gpg}, which is a GnuPG encrypted file
(@pxref{GnuPG and EasyPG Assistant Configuration}).
-If that fails, the unencrypted netrc files @code{~/.authinfo} and
address@hidden/.netrc} will be used.
+If that fails, the unencrypted netrc files @file{~/.authinfo} and
address@hidden/.netrc} will be used.
The typical netrc line example is without a port.
@@ -363,9 +363,9 @@
The auth-source library lets you control logging output easily.
@defvar auth-source-debug
-Set this variable to 'trivia to see lots of output in *Messages*, or
-set it to a function that behaves like @code{message} to do your own
-logging.
+Set this variable to @code{'trivia} to see lots of output in
address@hidden, or set it to a function that behaves like
address@hidden to do your own logging.
@end defvar
The auth-source library only has a few functions for external use.
@@ -453,12 +453,12 @@
@appendix GnuPG and EasyPG Assistant Configuration
If you don't customize @code{auth-sources}, the auth-source library
-reads @code{~/.authinfo.gpg}, which is a GnuPG encrypted file. Then
-it will check @code{~/.authinfo} but it's not recommended to use such
+reads @file{~/.authinfo.gpg}, which is a GnuPG encrypted file. Then
+it will check @file{~/.authinfo} but it's not recommended to use such
an unencrypted file.
In Emacs 23 or later there is an option @code{auto-encryption-mode} to
-automatically decrypt @code{*.gpg} files. It is enabled by default.
+automatically decrypt @file{*.gpg} files. It is enabled by default.
If you are using earlier versions of Emacs, you will need:
@lisp
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/trunk r107768: Markup fixes for auth.texi,
Glenn Morris <=