From: Eric Abrahamsen <eric@ericabrahamsen.net>
To: David Masterson <dsmasterson@outlook.com>
Cc: 35261@debbugs.gnu.org
Subject: bug#35261: 26.1; EBDB Documentation
Date: Sat, 13 Apr 2019 18:50:26 -0700 [thread overview]
Message-ID: <87r2a5nyn1.fsf@ericabrahamsen.net> (raw)
In-Reply-To: <BYAPR07MB5734EEC82950A7CE8ED32202A5290@BYAPR07MB5734.namprd07.prod.outlook.com> (David Masterson's message of "Sat, 13 Apr 2019 21:26:31 +0000")
David Masterson <dsmasterson@outlook.com> writes:
> This is a documentation problem for EBDB.
>
> The documentation lacks clarity on how to setup EBDB for the first time
> in the case where you are *not* converting from BBDB or Org Contacts.
> More information is needed on how to create an EBDB database for the
> first time, how to setup the first record(s) that you put into the
> database, and (perhaps) an example session. As it is, the documentation
> is too esoteric for someone unfamiliar with EBDB (or BBDB) concepts to
> make heads or tails of it and get their feet wet.
Thanks for this report. Here's what the docs have now:
Assuming you have no records you want to migrate from other contact
management software, it is enough to call the top-level ~ebdb~ command.
This will create a new database at the location specified by
~ebdb-sources~ (see [The EBDB Database]), prompt you for a search
string, fail to find anything (because you don't have any records yet),
and finally open a EBDB buffer where you can start to make new records
(see [Creating Records]).
This is correct, though admittedly terse! I suppose I could break this
out more specifically: you should set `ebdb-sources' in advance. Then
you can create your new database either by calling the `ebdb' command,
or by associating EBDB with a mail user agent, and letting that agent
create records for you.
Or perhaps, if you have no records, the `ebdb' command could simply open
an *EBDB* buffer and then tell you, "you have no records, use 'c' to
create one"?
WDYT?
next prev parent reply other threads:[~2019-04-14 1:50 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-04-13 21:26 bug#35261: 26.1; EBDB Documentation David Masterson
2019-04-14 1:50 ` Eric Abrahamsen [this message]
2019-04-15 3:50 ` David Masterson
2019-04-15 5:07 ` Eric Abrahamsen
2019-04-15 20:56 ` David Masterson
2019-04-16 18:54 ` Eric Abrahamsen
2019-04-17 3:14 ` David Masterson
2019-04-18 19:51 ` Eric Abrahamsen
2019-04-19 22:22 ` David Masterson
2019-04-16 21:10 ` Eric Abrahamsen
2019-04-17 3:41 ` David Masterson
2019-04-18 20:33 ` Eric Abrahamsen
2019-04-19 22:31 ` David Masterson
2019-04-20 0:00 ` Eric Abrahamsen
2019-04-21 2:08 ` David Masterson
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87r2a5nyn1.fsf@ericabrahamsen.net \
--to=eric@ericabrahamsen.net \
--cc=35261@debbugs.gnu.org \
--cc=dsmasterson@outlook.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.