* bug#35261: 26.1; EBDB Documentation @ 2019-04-13 21:26 David Masterson 2019-04-14 1:50 ` Eric Abrahamsen 0 siblings, 1 reply; 15+ messages in thread From: David Masterson @ 2019-04-13 21:26 UTC (permalink / raw) To: 35261; +Cc: eric@ericabrahamsen.net 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. In GNU Emacs 26.1 (build 1, x86_64-unknown-cygwin, X toolkit, Xaw3d scroll bars) of 2018-05-28 built on DESKTOP Repository revision: d802fa4a0642157d7aff9a9d599785df7604e4d1 Windowing system distributor 'The Cygwin/X Project', version 11.0.11906000 Recent messages: Cut: Subtree(s) with 1127 characters Subtree archived in file: ~/DSM/org/Finances.org_archive Mark set [2 times] Saving file /home/David/DSM/org/Finances.org... Wrote /home/David/DSM/org/Finances.org Composing main Info directory...done Auto-saving...done Quit No apropos matches for ‘report-emacs-bugs’ Type C-x 1 to delete the help window. Configured using: 'configure --srcdir=/home/kbrown/src/cygemacs/emacs-26.1-1.x86_64/src/emacs-26.1 --prefix=/usr --exec-prefix=/usr --localstatedir=/var --sysconfdir=/etc --docdir=/usr/share/doc/emacs --htmldir=/usr/share/doc/emacs/html -C --with-x-toolkit=lucid 'CFLAGS=-ggdb -O2 -pipe -Wall -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -fstack-protector-strong --param=ssp-buffer-size=4 -fdebug-prefix-map=/home/kbrown/src/cygemacs/emacs-26.1-1.x86_64/build=/usr/src/debug/emacs-26.1-1 -fdebug-prefix-map=/home/kbrown/src/cygemacs/emacs-26.1-1.x86_64/src/emacs-26.1=/usr/src/debug/emacs-26.1-1' CPPFLAGS= LDFLAGS=' Configured features: XAW3D XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND DBUS GSETTINGS NOTIFY ACL GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB TOOLKIT_SCROLL_BARS LUCID X11 THREADS LCMS2 Important settings: value of $LANG: en_US.UTF-8 locale-coding-system: utf-8-unix Major mode: Dired by name Minor modes in effect: diff-auto-refine-mode: t TeX-PDF-mode: t shell-dirtrack-mode: t show-paren-mode: t ido-everywhere: t tooltip-mode: t global-eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t buffer-read-only: t line-number-mode: t transient-mark-mode: t Load-path shadows: /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox hides /home/David/.emacs.d/elpa/org-9.2.3/ox /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-texinfo hides /home/David/.emacs.d/elpa/org-9.2.3/ox-texinfo /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-publish hides /home/David/.emacs.d/elpa/org-9.2.3/ox-publish /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-org hides /home/David/.emacs.d/elpa/org-9.2.3/ox-org /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-odt hides /home/David/.emacs.d/elpa/org-9.2.3/ox-odt /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-md hides /home/David/.emacs.d/elpa/org-9.2.3/ox-md /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-man hides /home/David/.emacs.d/elpa/org-9.2.3/ox-man /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-latex hides /home/David/.emacs.d/elpa/org-9.2.3/ox-latex /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-icalendar hides /home/David/.emacs.d/elpa/org-9.2.3/ox-icalendar /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-html hides /home/David/.emacs.d/elpa/org-9.2.3/ox-html /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-beamer hides /home/David/.emacs.d/elpa/org-9.2.3/ox-beamer /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-ascii hides /home/David/.emacs.d/elpa/org-9.2.3/ox-ascii /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org hides /home/David/.emacs.d/elpa/org-9.2.3/org /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-w3m hides /home/David/.emacs.d/elpa/org-9.2.3/org-w3m /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-version hides /home/David/.emacs.d/elpa/org-9.2.3/org-version /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-timer hides /home/David/.emacs.d/elpa/org-9.2.3/org-timer /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-tempo hides /home/David/.emacs.d/elpa/org-9.2.3/org-tempo /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-table hides /home/David/.emacs.d/elpa/org-9.2.3/org-table /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-src hides /home/David/.emacs.d/elpa/org-9.2.3/org-src /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-rmail hides /home/David/.emacs.d/elpa/org-9.2.3/org-rmail /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-protocol hides /home/David/.emacs.d/elpa/org-9.2.3/org-protocol /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-plot hides /home/David/.emacs.d/elpa/org-9.2.3/org-plot /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-pcomplete hides /home/David/.emacs.d/elpa/org-9.2.3/org-pcomplete /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-mouse hides /home/David/.emacs.d/elpa/org-9.2.3/org-mouse /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-mobile hides /home/David/.emacs.d/elpa/org-9.2.3/org-mobile /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-mhe hides /home/David/.emacs.d/elpa/org-9.2.3/org-mhe /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-macs hides /home/David/.emacs.d/elpa/org-9.2.3/org-macs /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-macro hides /home/David/.emacs.d/elpa/org-9.2.3/org-macro /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-loaddefs hides /home/David/.emacs.d/elpa/org-9.2.3/org-loaddefs /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-list hides /home/David/.emacs.d/elpa/org-9.2.3/org-list /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-lint hides /home/David/.emacs.d/elpa/org-9.2.3/org-lint /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-irc hides /home/David/.emacs.d/elpa/org-9.2.3/org-irc /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-install hides /home/David/.emacs.d/elpa/org-9.2.3/org-install /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-inlinetask hides /home/David/.emacs.d/elpa/org-9.2.3/org-inlinetask /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-info hides /home/David/.emacs.d/elpa/org-9.2.3/org-info /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-indent hides /home/David/.emacs.d/elpa/org-9.2.3/org-indent /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-id hides /home/David/.emacs.d/elpa/org-9.2.3/org-id /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-habit hides /home/David/.emacs.d/elpa/org-9.2.3/org-habit /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-goto hides /home/David/.emacs.d/elpa/org-9.2.3/org-goto /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-gnus hides /home/David/.emacs.d/elpa/org-9.2.3/org-gnus /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-footnote hides /home/David/.emacs.d/elpa/org-9.2.3/org-footnote /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-feed hides /home/David/.emacs.d/elpa/org-9.2.3/org-feed /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-faces hides /home/David/.emacs.d/elpa/org-9.2.3/org-faces /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-eww hides /home/David/.emacs.d/elpa/org-9.2.3/org-eww /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-eshell hides /home/David/.emacs.d/elpa/org-9.2.3/org-eshell /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-entities hides /home/David/.emacs.d/elpa/org-9.2.3/org-entities /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-element hides /home/David/.emacs.d/elpa/org-9.2.3/org-element /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-duration hides /home/David/.emacs.d/elpa/org-9.2.3/org-duration /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-docview hides /home/David/.emacs.d/elpa/org-9.2.3/org-docview /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-datetree hides /home/David/.emacs.d/elpa/org-9.2.3/org-datetree /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-ctags hides /home/David/.emacs.d/elpa/org-9.2.3/org-ctags /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-crypt hides /home/David/.emacs.d/elpa/org-9.2.3/org-crypt /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-compat hides /home/David/.emacs.d/elpa/org-9.2.3/org-compat /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-colview hides /home/David/.emacs.d/elpa/org-9.2.3/org-colview /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-clock hides /home/David/.emacs.d/elpa/org-9.2.3/org-clock /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-capture hides /home/David/.emacs.d/elpa/org-9.2.3/org-capture /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-bibtex hides /home/David/.emacs.d/elpa/org-9.2.3/org-bibtex /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-bbdb hides /home/David/.emacs.d/elpa/org-9.2.3/org-bbdb /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-attach hides /home/David/.emacs.d/elpa/org-9.2.3/org-attach /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-archive hides /home/David/.emacs.d/elpa/org-9.2.3/org-archive /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-agenda hides /home/David/.emacs.d/elpa/org-9.2.3/org-agenda /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob hides /home/David/.emacs.d/elpa/org-9.2.3/ob /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-vala hides /home/David/.emacs.d/elpa/org-9.2.3/ob-vala /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-tangle hides /home/David/.emacs.d/elpa/org-9.2.3/ob-tangle /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-table hides /home/David/.emacs.d/elpa/org-9.2.3/ob-table /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-stan hides /home/David/.emacs.d/elpa/org-9.2.3/ob-stan /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-sqlite hides /home/David/.emacs.d/elpa/org-9.2.3/ob-sqlite /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-sql hides /home/David/.emacs.d/elpa/org-9.2.3/ob-sql /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-shen hides /home/David/.emacs.d/elpa/org-9.2.3/ob-shen /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-shell hides /home/David/.emacs.d/elpa/org-9.2.3/ob-shell /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-sed hides /home/David/.emacs.d/elpa/org-9.2.3/ob-sed /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-screen hides /home/David/.emacs.d/elpa/org-9.2.3/ob-screen /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-scheme hides /home/David/.emacs.d/elpa/org-9.2.3/ob-scheme /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-sass hides /home/David/.emacs.d/elpa/org-9.2.3/ob-sass /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ruby hides /home/David/.emacs.d/elpa/org-9.2.3/ob-ruby /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ref hides /home/David/.emacs.d/elpa/org-9.2.3/ob-ref /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-R hides /home/David/.emacs.d/elpa/org-9.2.3/ob-R /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-python hides /home/David/.emacs.d/elpa/org-9.2.3/ob-python /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-processing hides /home/David/.emacs.d/elpa/org-9.2.3/ob-processing /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-plantuml hides /home/David/.emacs.d/elpa/org-9.2.3/ob-plantuml /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-picolisp hides /home/David/.emacs.d/elpa/org-9.2.3/ob-picolisp /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-perl hides /home/David/.emacs.d/elpa/org-9.2.3/ob-perl /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-org hides /home/David/.emacs.d/elpa/org-9.2.3/ob-org /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-octave hides /home/David/.emacs.d/elpa/org-9.2.3/ob-octave /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ocaml hides /home/David/.emacs.d/elpa/org-9.2.3/ob-ocaml /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-mscgen hides /home/David/.emacs.d/elpa/org-9.2.3/ob-mscgen /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-maxima hides /home/David/.emacs.d/elpa/org-9.2.3/ob-maxima /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-matlab hides /home/David/.emacs.d/elpa/org-9.2.3/ob-matlab /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-makefile hides /home/David/.emacs.d/elpa/org-9.2.3/ob-makefile /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-lua hides /home/David/.emacs.d/elpa/org-9.2.3/ob-lua /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-lob hides /home/David/.emacs.d/elpa/org-9.2.3/ob-lob /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-lisp hides /home/David/.emacs.d/elpa/org-9.2.3/ob-lisp /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-lilypond hides /home/David/.emacs.d/elpa/org-9.2.3/ob-lilypond /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ledger hides /home/David/.emacs.d/elpa/org-9.2.3/ob-ledger /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-latex hides /home/David/.emacs.d/elpa/org-9.2.3/ob-latex /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-keys hides /home/David/.emacs.d/elpa/org-9.2.3/ob-keys /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-js hides /home/David/.emacs.d/elpa/org-9.2.3/ob-js /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-java hides /home/David/.emacs.d/elpa/org-9.2.3/ob-java /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-J hides /home/David/.emacs.d/elpa/org-9.2.3/ob-J /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-io hides /home/David/.emacs.d/elpa/org-9.2.3/ob-io /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-hledger hides /home/David/.emacs.d/elpa/org-9.2.3/ob-hledger /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-haskell hides /home/David/.emacs.d/elpa/org-9.2.3/ob-haskell /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-groovy hides /home/David/.emacs.d/elpa/org-9.2.3/ob-groovy /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-gnuplot hides /home/David/.emacs.d/elpa/org-9.2.3/ob-gnuplot /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-fortran hides /home/David/.emacs.d/elpa/org-9.2.3/ob-fortran /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-forth hides /home/David/.emacs.d/elpa/org-9.2.3/ob-forth /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-exp hides /home/David/.emacs.d/elpa/org-9.2.3/ob-exp /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-eval hides /home/David/.emacs.d/elpa/org-9.2.3/ob-eval /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-emacs-lisp hides /home/David/.emacs.d/elpa/org-9.2.3/ob-emacs-lisp /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ebnf hides /home/David/.emacs.d/elpa/org-9.2.3/ob-ebnf /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-dot hides /home/David/.emacs.d/elpa/org-9.2.3/ob-dot /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ditaa hides /home/David/.emacs.d/elpa/org-9.2.3/ob-ditaa /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-css hides /home/David/.emacs.d/elpa/org-9.2.3/ob-css /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-core hides /home/David/.emacs.d/elpa/org-9.2.3/ob-core /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-coq hides /home/David/.emacs.d/elpa/org-9.2.3/ob-coq /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-comint hides /home/David/.emacs.d/elpa/org-9.2.3/ob-comint /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-clojure hides /home/David/.emacs.d/elpa/org-9.2.3/ob-clojure /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-calc hides /home/David/.emacs.d/elpa/org-9.2.3/ob-calc /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-C hides /home/David/.emacs.d/elpa/org-9.2.3/ob-C /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-awk hides /home/David/.emacs.d/elpa/org-9.2.3/ob-awk /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-asymptote hides /home/David/.emacs.d/elpa/org-9.2.3/ob-asymptote /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-abc hides /home/David/.emacs.d/elpa/org-9.2.3/ob-abc /home/David/.emacs.d/elpa/htmlize-1.54/htmlize hides /home/David/.emacs.d/my.elisp/htmlize /home/David/.emacs.d/elpa/auctex-12.1.2/tex-site hides /usr/share/emacs/site-lisp/tex-site /home/David/.emacs.d/elpa/auctex-12.1.2/auctex hides /usr/share/emacs/site-lisp/auctex /home/David/.emacs.d/elpa/auctex-12.1.2/toolbar-x hides /usr/share/emacs/site-lisp/auctex/toolbar-x /home/David/.emacs.d/elpa/auctex-12.1.2/texmathp hides /usr/share/emacs/site-lisp/auctex/texmathp /home/David/.emacs.d/elpa/auctex-12.1.2/tex hides /usr/share/emacs/site-lisp/auctex/tex /home/David/.emacs.d/elpa/auctex-12.1.2/tex-style hides /usr/share/emacs/site-lisp/auctex/tex-style /home/David/.emacs.d/elpa/auctex-12.1.2/tex-mik hides /usr/share/emacs/site-lisp/auctex/tex-mik /home/David/.emacs.d/elpa/auctex-12.1.2/tex-jp hides /usr/share/emacs/site-lisp/auctex/tex-jp /home/David/.emacs.d/elpa/auctex-12.1.2/tex-ispell hides /usr/share/emacs/site-lisp/auctex/tex-ispell /home/David/.emacs.d/elpa/auctex-12.1.2/tex-info hides /usr/share/emacs/site-lisp/auctex/tex-info /home/David/.emacs.d/elpa/auctex-12.1.2/tex-font hides /usr/share/emacs/site-lisp/auctex/tex-font /home/David/.emacs.d/elpa/auctex-12.1.2/tex-fold hides /usr/share/emacs/site-lisp/auctex/tex-fold /home/David/.emacs.d/elpa/auctex-12.1.2/tex-buf hides /usr/share/emacs/site-lisp/auctex/tex-buf /home/David/.emacs.d/elpa/auctex-12.1.2/tex-bar hides /usr/share/emacs/site-lisp/auctex/tex-bar /home/David/.emacs.d/elpa/auctex-12.1.2/prv-emacs hides /usr/share/emacs/site-lisp/auctex/prv-emacs /home/David/.emacs.d/elpa/auctex-12.1.2/preview hides /usr/share/emacs/site-lisp/auctex/preview /home/David/.emacs.d/elpa/auctex-12.1.2/plain-tex hides /usr/share/emacs/site-lisp/auctex/plain-tex /home/David/.emacs.d/elpa/auctex-12.1.2/multi-prompt hides /usr/share/emacs/site-lisp/auctex/multi-prompt /home/David/.emacs.d/elpa/auctex-12.1.2/latex hides /usr/share/emacs/site-lisp/auctex/latex /home/David/.emacs.d/elpa/auctex-12.1.2/font-latex hides /usr/share/emacs/site-lisp/auctex/font-latex /home/David/.emacs.d/elpa/auctex-12.1.2/context hides /usr/share/emacs/site-lisp/auctex/context /home/David/.emacs.d/elpa/auctex-12.1.2/context-nl hides /usr/share/emacs/site-lisp/auctex/context-nl /home/David/.emacs.d/elpa/auctex-12.1.2/context-en hides /usr/share/emacs/site-lisp/auctex/context-en /home/David/.emacs.d/elpa/auctex-12.1.2/bib-cite hides /usr/share/emacs/site-lisp/auctex/bib-cite /usr/share/emacs/site-lisp/lilypond-init hides /usr/share/emacs/site-lisp/site-start.d/lilypond-init /usr/share/emacs/site-lisp/htmlfontify hides /usr/share/emacs/26.1/lisp/htmlfontify /usr/share/emacs/site-lisp/hfy-cmap hides /usr/share/emacs/26.1/lisp/hfy-cmap /home/David/.emacs.d/elpa/python-0.26.1/python hides /usr/share/emacs/26.1/lisp/progmodes/python /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox hides /usr/share/emacs/26.1/lisp/org/ox /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-texinfo hides /usr/share/emacs/26.1/lisp/org/ox-texinfo /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-publish hides /usr/share/emacs/26.1/lisp/org/ox-publish /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-org hides /usr/share/emacs/26.1/lisp/org/ox-org /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-odt hides /usr/share/emacs/26.1/lisp/org/ox-odt /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-md hides /usr/share/emacs/26.1/lisp/org/ox-md /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-man hides /usr/share/emacs/26.1/lisp/org/ox-man /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-latex hides /usr/share/emacs/26.1/lisp/org/ox-latex /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-icalendar hides /usr/share/emacs/26.1/lisp/org/ox-icalendar /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-html hides /usr/share/emacs/26.1/lisp/org/ox-html /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-beamer hides /usr/share/emacs/26.1/lisp/org/ox-beamer /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ox-ascii hides /usr/share/emacs/26.1/lisp/org/ox-ascii /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org hides /usr/share/emacs/26.1/lisp/org/org /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-w3m hides /usr/share/emacs/26.1/lisp/org/org-w3m /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-version hides /usr/share/emacs/26.1/lisp/org/org-version /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-timer hides /usr/share/emacs/26.1/lisp/org/org-timer /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-table hides /usr/share/emacs/26.1/lisp/org/org-table /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-src hides /usr/share/emacs/26.1/lisp/org/org-src /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-rmail hides /usr/share/emacs/26.1/lisp/org/org-rmail /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-protocol hides /usr/share/emacs/26.1/lisp/org/org-protocol /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-plot hides /usr/share/emacs/26.1/lisp/org/org-plot /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-pcomplete hides /usr/share/emacs/26.1/lisp/org/org-pcomplete /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-mouse hides /usr/share/emacs/26.1/lisp/org/org-mouse /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-mobile hides /usr/share/emacs/26.1/lisp/org/org-mobile /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-mhe hides /usr/share/emacs/26.1/lisp/org/org-mhe /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-macs hides /usr/share/emacs/26.1/lisp/org/org-macs /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-macro hides /usr/share/emacs/26.1/lisp/org/org-macro /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-loaddefs hides /usr/share/emacs/26.1/lisp/org/org-loaddefs /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-list hides /usr/share/emacs/26.1/lisp/org/org-list /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-lint hides /usr/share/emacs/26.1/lisp/org/org-lint /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-irc hides /usr/share/emacs/26.1/lisp/org/org-irc /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-install hides /usr/share/emacs/26.1/lisp/org/org-install /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-inlinetask hides /usr/share/emacs/26.1/lisp/org/org-inlinetask /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-info hides /usr/share/emacs/26.1/lisp/org/org-info /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-indent hides /usr/share/emacs/26.1/lisp/org/org-indent /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-id hides /usr/share/emacs/26.1/lisp/org/org-id /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-habit hides /usr/share/emacs/26.1/lisp/org/org-habit /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-gnus hides /usr/share/emacs/26.1/lisp/org/org-gnus /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-footnote hides /usr/share/emacs/26.1/lisp/org/org-footnote /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-feed hides /usr/share/emacs/26.1/lisp/org/org-feed /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-faces hides /usr/share/emacs/26.1/lisp/org/org-faces /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-eww hides /usr/share/emacs/26.1/lisp/org/org-eww /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-eshell hides /usr/share/emacs/26.1/lisp/org/org-eshell /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-entities hides /usr/share/emacs/26.1/lisp/org/org-entities /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-element hides /usr/share/emacs/26.1/lisp/org/org-element /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-duration hides /usr/share/emacs/26.1/lisp/org/org-duration /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-docview hides /usr/share/emacs/26.1/lisp/org/org-docview /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-datetree hides /usr/share/emacs/26.1/lisp/org/org-datetree /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-ctags hides /usr/share/emacs/26.1/lisp/org/org-ctags /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-crypt hides /usr/share/emacs/26.1/lisp/org/org-crypt /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-compat hides /usr/share/emacs/26.1/lisp/org/org-compat /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-colview hides /usr/share/emacs/26.1/lisp/org/org-colview /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-clock hides /usr/share/emacs/26.1/lisp/org/org-clock /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-capture hides /usr/share/emacs/26.1/lisp/org/org-capture /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-bibtex hides /usr/share/emacs/26.1/lisp/org/org-bibtex /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-bbdb hides /usr/share/emacs/26.1/lisp/org/org-bbdb /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-attach hides /usr/share/emacs/26.1/lisp/org/org-attach /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-archive hides /usr/share/emacs/26.1/lisp/org/org-archive /home/David/.emacs.d/elpa/org-plus-contrib-20190408/org-agenda hides /usr/share/emacs/26.1/lisp/org/org-agenda /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob hides /usr/share/emacs/26.1/lisp/org/ob /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-vala hides /usr/share/emacs/26.1/lisp/org/ob-vala /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-tangle hides /usr/share/emacs/26.1/lisp/org/ob-tangle /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-table hides /usr/share/emacs/26.1/lisp/org/ob-table /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-stan hides /usr/share/emacs/26.1/lisp/org/ob-stan /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-sqlite hides /usr/share/emacs/26.1/lisp/org/ob-sqlite /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-sql hides /usr/share/emacs/26.1/lisp/org/ob-sql /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-shen hides /usr/share/emacs/26.1/lisp/org/ob-shen /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-shell hides /usr/share/emacs/26.1/lisp/org/ob-shell /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-sed hides /usr/share/emacs/26.1/lisp/org/ob-sed /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-screen hides /usr/share/emacs/26.1/lisp/org/ob-screen /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-scheme hides /usr/share/emacs/26.1/lisp/org/ob-scheme /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-sass hides /usr/share/emacs/26.1/lisp/org/ob-sass /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ruby hides /usr/share/emacs/26.1/lisp/org/ob-ruby /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ref hides /usr/share/emacs/26.1/lisp/org/ob-ref /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-R hides /usr/share/emacs/26.1/lisp/org/ob-R /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-python hides /usr/share/emacs/26.1/lisp/org/ob-python /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-processing hides /usr/share/emacs/26.1/lisp/org/ob-processing /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-plantuml hides /usr/share/emacs/26.1/lisp/org/ob-plantuml /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-picolisp hides /usr/share/emacs/26.1/lisp/org/ob-picolisp /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-perl hides /usr/share/emacs/26.1/lisp/org/ob-perl /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-org hides /usr/share/emacs/26.1/lisp/org/ob-org /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-octave hides /usr/share/emacs/26.1/lisp/org/ob-octave /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ocaml hides /usr/share/emacs/26.1/lisp/org/ob-ocaml /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-mscgen hides /usr/share/emacs/26.1/lisp/org/ob-mscgen /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-maxima hides /usr/share/emacs/26.1/lisp/org/ob-maxima /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-matlab hides /usr/share/emacs/26.1/lisp/org/ob-matlab /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-makefile hides /usr/share/emacs/26.1/lisp/org/ob-makefile /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-lua hides /usr/share/emacs/26.1/lisp/org/ob-lua /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-lob hides /usr/share/emacs/26.1/lisp/org/ob-lob /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-lisp hides /usr/share/emacs/26.1/lisp/org/ob-lisp /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-lilypond hides /usr/share/emacs/26.1/lisp/org/ob-lilypond /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ledger hides /usr/share/emacs/26.1/lisp/org/ob-ledger /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-latex hides /usr/share/emacs/26.1/lisp/org/ob-latex /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-keys hides /usr/share/emacs/26.1/lisp/org/ob-keys /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-js hides /usr/share/emacs/26.1/lisp/org/ob-js /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-java hides /usr/share/emacs/26.1/lisp/org/ob-java /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-J hides /usr/share/emacs/26.1/lisp/org/ob-J /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-io hides /usr/share/emacs/26.1/lisp/org/ob-io /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-hledger hides /usr/share/emacs/26.1/lisp/org/ob-hledger /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-haskell hides /usr/share/emacs/26.1/lisp/org/ob-haskell /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-groovy hides /usr/share/emacs/26.1/lisp/org/ob-groovy /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-gnuplot hides /usr/share/emacs/26.1/lisp/org/ob-gnuplot /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-fortran hides /usr/share/emacs/26.1/lisp/org/ob-fortran /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-forth hides /usr/share/emacs/26.1/lisp/org/ob-forth /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-exp hides /usr/share/emacs/26.1/lisp/org/ob-exp /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-eval hides /usr/share/emacs/26.1/lisp/org/ob-eval /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-emacs-lisp hides /usr/share/emacs/26.1/lisp/org/ob-emacs-lisp /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ebnf hides /usr/share/emacs/26.1/lisp/org/ob-ebnf /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-dot hides /usr/share/emacs/26.1/lisp/org/ob-dot /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-ditaa hides /usr/share/emacs/26.1/lisp/org/ob-ditaa /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-css hides /usr/share/emacs/26.1/lisp/org/ob-css /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-core hides /usr/share/emacs/26.1/lisp/org/ob-core /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-coq hides /usr/share/emacs/26.1/lisp/org/ob-coq /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-comint hides /usr/share/emacs/26.1/lisp/org/ob-comint /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-clojure hides /usr/share/emacs/26.1/lisp/org/ob-clojure /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-calc hides /usr/share/emacs/26.1/lisp/org/ob-calc /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-C hides /usr/share/emacs/26.1/lisp/org/ob-C /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-awk hides /usr/share/emacs/26.1/lisp/org/ob-awk /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-asymptote hides /usr/share/emacs/26.1/lisp/org/ob-asymptote /home/David/.emacs.d/elpa/org-plus-contrib-20190408/ob-abc hides /usr/share/emacs/26.1/lisp/org/ob-abc Features: (shadow emacsbug sendmail eieio-opt speedbar sb-image ezimage dframe help-fns radix-tree apropos org-archive dired-aux log-edit add-log diff-mode pcvs pcvs-parse pcvs-info pcvs-defs pcvs-util ewoc preview prv-emacs tex-bar tex-buf toolbar-x font-latex latex latex-flymake flymake-proc flymake warnings tex-ispell tex-style tex dbus crm tex-mode compile latexenc org-table mhtml-mode css-mode smie color eww mm-url url-queue url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util shr svg xml browse-url js json map imenu thingatpt cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs sgml-mode dom ox-texinfo ox-org ox-odt rng-loc rng-uri rng-parse rng-match rng-dt rng-util rng-pttrn nxml-parse nxml-ns nxml-enc xmltok nxml-util ox-latex ox-icalendar ox-html table ox-ascii ox-publish ox shell vc-cvs org-eldoc org-journal flyspell ispell org-indent org-toc org-man org-git-link org-bookmark bookmark pp org-eshell esh-var esh-io esh-cmd esh-opt esh-ext esh-proc esh-arg esh-groups eshell esh-module esh-mode esh-util org-w3m org-tempo tempo org-rmail org-protocol org-mouse org-mhe org-irc org-inlinetask org-info org-id org-habit org-agenda org-gnus nnir org-eww org-docview doc-view jka-compr image-mode org-crypt org-bibtex bibtex org-bbdb org-element avl-tree generator org ob ob-tangle ob-ref ob-lob ob-table ob-exp org-macro org-footnote org-src ob-comint ob-keys org-pcomplete pcomplete comint ring org-list org-faces org-entities noutline outline easy-mmode org-version ob-emacs-lisp ob-core ob-eval org-compat advice org-macs org-loaddefs find-func cal-menu calendar cal-loaddefs cl-extra help-mode sort smiley ansi-color gnus-cite mail-extr qp gnus-async gnus-bcklg gnus-ml disp-table cursor-sensor nndraft nnmh nnfolder utf-7 network-stream nsm starttls gnus-agent gnus-srvr gnus-score score-mode nnvirtual gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime dig mailcap nntp gnus-cache gnus-sum gnus-group gnus-undo gnus-start gnus-cloud nnimap nnmail mail-source tls gnutls utf7 netrc nnoo parse-time gnus-spec gnus-int gnus-range message rmc puny dired dired-loaddefs format-spec rfc822 mml mml-sec epa derived epg mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader gnus-win gnus nnheader gnus-util rmail rmail-loaddefs rfc2047 rfc2045 ietf-drums mail-utils mm-util mail-prsvr wid-edit elec-pair finder-inf tex-site kotl-autoloads edmacro kmacro org2blog-autoloads info package easymenu epg-config url-handlers url-parse auth-source cl-seq eieio eieio-core cl-macs eieio-loaddefs password-cache url-vars misterioso-theme paren desktop frameset cus-start cus-load ido seq byte-opt bytecomp byte-compile cconv htmlize cl gv cl-loaddefs cl-lib time-date mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel term/x-win x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list replace newcomment text-mode elisp-mode lisp-mode prog-mode register page menu-bar rfn-eshadow isearch timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core term/tty-colors frame cl-generic cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese composite charscript charprop case-table epa-hook jka-cmpr-hook help simple abbrev obarray minibuffer cl-preloaded nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote dbusbind gfilenotify lcms2 dynamic-setting system-font-setting font-render-setting x-toolkit x multi-tty make-network-process emacs) Memory information: ((conses 16 583424 109192) (symbols 48 55615 3) (miscs 40 766 3073) (strings 32 174595 15218) (string-bytes 1 5357015) (vectors 16 61668) (vector-slots 8 1402446 30800) (floats 8 542 569) (intervals 56 14318 3539) (buffers 992 59)) ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-13 21:26 bug#35261: 26.1; EBDB Documentation David Masterson @ 2019-04-14 1:50 ` Eric Abrahamsen 2019-04-15 3:50 ` David Masterson 0 siblings, 1 reply; 15+ messages in thread From: Eric Abrahamsen @ 2019-04-14 1:50 UTC (permalink / raw) To: David Masterson; +Cc: 35261 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? ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-14 1:50 ` Eric Abrahamsen @ 2019-04-15 3:50 ` David Masterson 2019-04-15 5:07 ` Eric Abrahamsen 0 siblings, 1 reply; 15+ messages in thread From: David Masterson @ 2019-04-15 3:50 UTC (permalink / raw) To: Eric Abrahamsen; +Cc: 35261@debbugs.gnu.org Eric Abrahamsen <eric@ericabrahamsen.net> writes: > 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? First, in the "Getting Started" section, there are the two subsections on migration. At first glance, I assumed (incorrectly) that those were the ways to get started and missed the rest of what was said at the top level. Therefore, I might suggest that the top level "Getting Started" section be an short intro to EBDB with (perhaps) references to key variables for setup. Then have three subsections (or more) where the first in creating the database from scratch, second is migration from BBDB, and third is migration from Org Contacts. Second, the top-level should probably reference where to find the internal details of the database structure and record structure(s). This should also be in the subsections to some degree. Perhaps the top-level should simply reference the details in the sub-levels. Third, the creation process should probably have an example script to show the user what to expect. In particular, I get an error when I try to create my first record in EBDB using 'c'. I'm not sure if it is a problem with not having setup a database variable, record variable, record structure variable, or what. I'm just beginning to experiment with EBDB, but I'm familiar with the concepts. Emacs/EBDB and its extensive variables can make it difficult to determine where to start to configure things if the Info page doesn't lead through it. Fourth, having 'c' tell you that "you have no records" is not to helpful in that what you need is how to setup to create records. Fifth, there is no EBDB mailing list to ask questions on?? -- David ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-15 3:50 ` David Masterson @ 2019-04-15 5:07 ` Eric Abrahamsen 2019-04-15 20:56 ` David Masterson 0 siblings, 1 reply; 15+ messages in thread From: Eric Abrahamsen @ 2019-04-15 5:07 UTC (permalink / raw) To: David Masterson; +Cc: 35261@debbugs.gnu.org On 04/15/19 03:50 AM, David Masterson wrote: > Eric Abrahamsen <eric@ericabrahamsen.net> writes: > >> 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? > > First, in the "Getting Started" section, there are the two subsections > on migration. At first glance, I assumed (incorrectly) that those were > the ways to get started and missed the rest of what was said at the top > level. Therefore, I might suggest that the top level "Getting Started" > section be an short intro to EBDB with (perhaps) references to key > variables for setup. Then have three subsections (or more) where the > first in creating the database from scratch, second is migration from > BBDB, and third is migration from Org Contacts. That makes sense. > Second, the top-level should probably reference where to find the > internal details of the database structure and record structure(s). > This should also be in the subsections to some degree. Perhaps the > top-level should simply reference the details in the sub-levels. Ditto. > Third, the creation process should probably have an example script to > show the user what to expect. In particular, I get an error when I try > to create my first record in EBDB using 'c'. I'm not sure if it is a > problem with not having setup a database variable, record variable, > record structure variable, or what. I'm just beginning to experiment > with EBDB, but I'm familiar with the concepts. Emacs/EBDB and its > extensive variables can make it difficult to determine where to start to > configure things if the Info page doesn't lead through it. > > Fourth, having 'c' tell you that "you have no records" is not to helpful > in that what you need is how to setup to create records. This doesn't seem right: it's the `ebdb' command that tells you the database is empty (and that message should include a mention of 'c'). 'c' prompts for the creation of a record. Do you remember what sort of error you got during record creation? There shouldn't be anything you have to do in advance, except maybe confirm that you want to create a new database at the default location. > Fifth, there is no EBDB mailing list to ask questions on?? I don't think new mailing lists are made for specific packages very often any more. In the case of EBDB, you can open an issue on the github page, email me directly, or do what you've done here, which is just fine (so long as you cc me). There's been some talk in the past about having the bug reporter prompt for specific packages to report bugs against, but that hasn't gone anywhere yet. Yours, Eric ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-15 5:07 ` Eric Abrahamsen @ 2019-04-15 20:56 ` David Masterson 2019-04-16 18:54 ` Eric Abrahamsen 2019-04-16 21:10 ` Eric Abrahamsen 0 siblings, 2 replies; 15+ messages in thread From: David Masterson @ 2019-04-15 20:56 UTC (permalink / raw) To: Eric Abrahamsen; +Cc: 35261@debbugs.gnu.org Eric Abrahamsen <eric@ericabrahamsen.net> writes: > On 04/15/19 03:50 AM, David Masterson wrote: >> Eric Abrahamsen <eric@ericabrahamsen.net> writes: >> >>> David Masterson <dsmasterson@outlook.com> writes: >> >>>> This is a documentation problem for EBDB. >> >> First, in the "Getting Started" section, there are the two subsections >> on migration. At first glance, I assumed (incorrectly) that those were >> the ways to get started and missed the rest of what was said at the top >> level. Therefore, I might suggest that the top level "Getting Started" >> section be an short intro to EBDB with (perhaps) references to key >> variables for setup. Then have three subsections (or more) where the >> first in creating the database from scratch, second is migration from >> BBDB, and third is migration from Org Contacts. > > That makes sense. > >> Second, the top-level should probably reference where to find the >> internal details of the database structure and record structure(s). >> This should also be in the subsections to some degree. Perhaps the >> top-level should simply reference the details in the sub-levels. > > Ditto. > >> Third, the creation process should probably have an example script to >> show the user what to expect. In particular, I get an error when I try >> to create my first record in EBDB using 'c'. I'm not sure if it is a >> problem with not having setup a database variable, record variable, >> record structure variable, or what. I'm just beginning to experiment >> with EBDB, but I'm familiar with the concepts. Emacs/EBDB and its >> extensive variables can make it difficult to determine where to start to >> configure things if the Info page doesn't lead through it. >> >> Fourth, having 'c' tell you that "you have no records" is not to helpful >> in that what you need is how to setup to create records. > > This doesn't seem right: it's the `ebdb' command that tells you the > database is empty (and that message should include a mention of 'c'). Actually, the first thing that the 'ebdb' seems to do is ask for a search string which is a little surprising on an empty database. I can see that people might want a quick command to find something in their database, but you shouldn't overload the 'ebdb' command that way. Have one command (ebdb) to startup EBDB and another command to start it up and find a record. Or, perhaps, two separate commands which people could always script together. > 'c' prompts for the creation of a record. Do you remember what sort of > error you got during record creation? There shouldn't be anything you > have to do in advance, except maybe confirm that you want to create a > new database at the default location. Good point. I kind of messed up that statement. The error I got was an error that basically is that I was putting in data for a field that was improper for the field. In this case, it was looking for an *email* address and I was assuming that any old text string would do. The error did not give the clue that it was specifically looking for a string that was formatted for "name@machine.com". So, there should be a clue in the documentation on how to read the error -- basically that the error is pointing out that the input doesn't fit the defined structure and (most importantly) how to find out what the defined structure is. On that, it seems that the documentation is still evolving in that area. For instance, looking at the documentation of ebdb-field-* variables says that they are obsolete as of 25.1 and the documentation is relatively low, so the error above would be confusing in that you'd wonder if you were looking at the right variable. -- David ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-15 20:56 ` David Masterson @ 2019-04-16 18:54 ` Eric Abrahamsen 2019-04-17 3:14 ` David Masterson 2019-04-16 21:10 ` Eric Abrahamsen 1 sibling, 1 reply; 15+ messages in thread From: Eric Abrahamsen @ 2019-04-16 18:54 UTC (permalink / raw) To: David Masterson; +Cc: 35261@debbugs.gnu.org On 04/15/19 20:56 PM, David Masterson wrote: > Eric Abrahamsen <eric@ericabrahamsen.net> writes: [...] >> This doesn't seem right: it's the `ebdb' command that tells you the >> database is empty (and that message should include a mention of 'c'). > > Actually, the first thing that the 'ebdb' seems to do is ask for a > search string which is a little surprising on an empty database. I can > see that people might want a quick command to find something in their > database, but you shouldn't overload the 'ebdb' command that way. Have > one command (ebdb) to startup EBDB and another command to start it up > and find a record. Or, perhaps, two separate commands which people > could always script together. Okay, it would make sense to have an `ebdb-start' command that just opens an *EBDB* buffer. >> 'c' prompts for the creation of a record. Do you remember what sort of >> error you got during record creation? There shouldn't be anything you >> have to do in advance, except maybe confirm that you want to create a >> new database at the default location. > > Good point. I kind of messed up that statement. The error I got was an > error that basically is that I was putting in data for a field that was > improper for the field. In this case, it was looking for an *email* > address and I was assuming that any old text string would do. The error > did not give the clue that it was specifically looking for a string that > was formatted for "name@machine.com". So, there should be a clue in the > documentation on how to read the error -- basically that the error is > pointing out that the input doesn't fit the defined structure and (most > importantly) how to find out what the defined structure is. Sure, I can add this as well. Actually I'm on the fence about requiring a "@" in mail fields at all, as it's possible someone might want to note a machine-local address for someone. I can't decide. But there are a few other fields (like the url field) that also do a bit of validation, and it would be good to explain that. > On that, it seems that the documentation is still evolving in that > area. For instance, looking at the documentation of ebdb-field-* > variables says that they are obsolete as of 25.1 and the documentation > is relatively low, so the error above would be confusing in that you'd > wonder if you were looking at the right variable. Unfortunately this doesn't have to do with EBDB, but rather with a weird interaction between the help system and EIEIO. Class names apparently once functioned as variables, but no longer do, and so Emacs complains when you try to treat one as a variable. You'll have better luck using help to look up the *function* definitions of the class names, not the variable definition. Eric ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-16 18:54 ` Eric Abrahamsen @ 2019-04-17 3:14 ` David Masterson 2019-04-18 19:51 ` Eric Abrahamsen 0 siblings, 1 reply; 15+ messages in thread From: David Masterson @ 2019-04-17 3:14 UTC (permalink / raw) To: Eric Abrahamsen; +Cc: 35261@debbugs.gnu.org Eric Abrahamsen <eric@ericabrahamsen.net> writes: > On 04/15/19 20:56 PM, David Masterson wrote: >> On that, it seems that the documentation is still evolving in that >> area. For instance, looking at the documentation of ebdb-field-* >> variables says that they are obsolete as of 25.1 and the documentation >> is relatively low, so the error above would be confusing in that you'd >> wonder if you were looking at the right variable. > Unfortunately this doesn't have to do with EBDB, but rather with a weird > interaction between the help system and EIEIO. Class names apparently > once functioned as variables, but no longer do, and so Emacs complains > when you try to treat one as a variable. You'll have better luck using > help to look up the *function* definitions of the class names, not the > variable definition. Ouch! That's not logical and will need some explanation somewhere. The logical assumption would be that the function that is asking for input is using some variable (structure) as a reference for what it expects as input, so, when the error reports a name in the error, the first thought would be that that is the structure to look at to get the clue as to what it's looking for. It's a little confusing (to say the least) for the lay person to see functions and variables with the same name. Something to lay out a little more as a primer in the Info docs? -- David ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-17 3:14 ` David Masterson @ 2019-04-18 19:51 ` Eric Abrahamsen 2019-04-19 22:22 ` David Masterson 0 siblings, 1 reply; 15+ messages in thread From: Eric Abrahamsen @ 2019-04-18 19:51 UTC (permalink / raw) To: David Masterson; +Cc: 35261@debbugs.gnu.org On 04/17/19 03:14 AM, David Masterson wrote: > Eric Abrahamsen <eric@ericabrahamsen.net> writes: > >> On 04/15/19 20:56 PM, David Masterson wrote: > >>> On that, it seems that the documentation is still evolving in that >>> area. For instance, looking at the documentation of ebdb-field-* >>> variables says that they are obsolete as of 25.1 and the documentation >>> is relatively low, so the error above would be confusing in that you'd >>> wonder if you were looking at the right variable. > >> Unfortunately this doesn't have to do with EBDB, but rather with a weird >> interaction between the help system and EIEIO. Class names apparently >> once functioned as variables, but no longer do, and so Emacs complains >> when you try to treat one as a variable. You'll have better luck using >> help to look up the *function* definitions of the class names, not the >> variable definition. > > Ouch! That's not logical and will need some explanation somewhere. The > logical assumption would be that the function that is asking for input > is using some variable (structure) as a reference for what it expects as > input, so, when the error reports a name in the error, the first thought > would be that that is the structure to look at to get the clue as to > what it's looking for. It's a little confusing (to say the least) for > the lay person to see functions and variables with the same name. > > Something to lay out a little more as a primer in the Info docs? Mmm, I'm not really inclined to spend a lot of time explaining the weirdnesses of Emacs help system in the EBDB manual, but maybe a pointer to the function docstrings of the class symbols would be okay. ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-18 19:51 ` Eric Abrahamsen @ 2019-04-19 22:22 ` David Masterson 0 siblings, 0 replies; 15+ messages in thread From: David Masterson @ 2019-04-19 22:22 UTC (permalink / raw) To: Eric Abrahamsen; +Cc: 35261@debbugs.gnu.org Eric Abrahamsen <eric@ericabrahamsen.net> writes: > On 04/17/19 03:14 AM, David Masterson wrote: >> Eric Abrahamsen <eric@ericabrahamsen.net> writes: >> >>> On 04/15/19 20:56 PM, David Masterson wrote: >> >>>> On that, it seems that the documentation is still evolving in that >>>> area. For instance, looking at the documentation of ebdb-field-* >>>> variables says that they are obsolete as of 25.1 and the documentation >>>> is relatively low, so the error above would be confusing in that you'd >>>> wonder if you were looking at the right variable. >> >>> Unfortunately this doesn't have to do with EBDB, but rather with a weird >>> interaction between the help system and EIEIO. Class names apparently >>> once functioned as variables, but no longer do, and so Emacs complains >>> when you try to treat one as a variable. You'll have better luck using >>> help to look up the *function* definitions of the class names, not the >>> variable definition. >> >> Ouch! That's not logical and will need some explanation somewhere. The >> logical assumption would be that the function that is asking for input >> is using some variable (structure) as a reference for what it expects as >> input, so, when the error reports a name in the error, the first thought >> would be that that is the structure to look at to get the clue as to >> what it's looking for. It's a little confusing (to say the least) for >> the lay person to see functions and variables with the same name. >> >> Something to lay out a little more as a primer in the Info docs? > > Mmm, I'm not really inclined to spend a lot of time explaining the > weirdnesses of Emacs help system in the EBDB manual, but maybe a pointer > to the function docstrings of the class symbols would be okay. Yeah, something to point you in the right direction. Try not to make it too 'lispy' for the newbies... -- David ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-15 20:56 ` David Masterson 2019-04-16 18:54 ` Eric Abrahamsen @ 2019-04-16 21:10 ` Eric Abrahamsen 2019-04-17 3:41 ` David Masterson 1 sibling, 1 reply; 15+ messages in thread From: Eric Abrahamsen @ 2019-04-16 21:10 UTC (permalink / raw) To: David Masterson; +Cc: 35261@debbugs.gnu.org On 04/15/19 20:56 PM, David Masterson wrote: > Eric Abrahamsen <eric@ericabrahamsen.net> writes: > >> On 04/15/19 03:50 AM, David Masterson wrote: >>> Eric Abrahamsen <eric@ericabrahamsen.net> writes: >>> >>>> David Masterson <dsmasterson@outlook.com> writes: >>> >>>>> This is a documentation problem for EBDB. >>> >>> First, in the "Getting Started" section, there are the two subsections >>> on migration. At first glance, I assumed (incorrectly) that those were >>> the ways to get started and missed the rest of what was said at the top >>> level. Therefore, I might suggest that the top level "Getting Started" >>> section be an short intro to EBDB with (perhaps) references to key >>> variables for setup. Then have three subsections (or more) where the >>> first in creating the database from scratch, second is migration from >>> BBDB, and third is migration from Org Contacts. >> >> That makes sense. >> >>> Second, the top-level should probably reference where to find the >>> internal details of the database structure and record structure(s). >>> This should also be in the subsections to some degree. Perhaps the >>> top-level should simply reference the details in the sub-levels. >> >> Ditto. >> >>> Third, the creation process should probably have an example script to >>> show the user what to expect. In particular, I get an error when I try >>> to create my first record in EBDB using 'c'. I'm not sure if it is a >>> problem with not having setup a database variable, record variable, >>> record structure variable, or what. I'm just beginning to experiment >>> with EBDB, but I'm familiar with the concepts. Emacs/EBDB and its >>> extensive variables can make it difficult to determine where to start to >>> configure things if the Info page doesn't lead through it. >>> >>> Fourth, having 'c' tell you that "you have no records" is not to helpful >>> in that what you need is how to setup to create records. >> >> This doesn't seem right: it's the `ebdb' command that tells you the >> database is empty (and that message should include a mention of 'c'). > > Actually, the first thing that the 'ebdb' seems to do is ask for a > search string which is a little surprising on an empty database. I can > see that people might want a quick command to find something in their > database, but you shouldn't overload the 'ebdb' command that way. Have > one command (ebdb) to startup EBDB and another command to start it up > and find a record. Or, perhaps, two separate commands which people > could always script together. Here's what the new version looks like: * Getting Started EBDB is a contact management package: it records information about people and organizations, and integrates with other Emacs software packages, mostly those concerned with sending and reading mail. The principle parts of EBDB are records, which represent people and organizations; fields, representing detailed data about records; and databases, which hold and persist records. There are a large number of configuration options listed in this manual, but the only one you might want to tweak in advance is ~ebdb-sources~ (see [The EBDB Database]), which controls where EBDB stores its records. ** Starting a New Database If you have no records you want to migrate from other contact management software, start by calling the command ~ebdb-open~. This will open a new buffer in ~ebdb-mode~, and prompt you to create a database, if one doesn't already exist. From there, you can use {{{kbd(c)}}} to make new records (see [Creating Records]). ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-16 21:10 ` Eric Abrahamsen @ 2019-04-17 3:41 ` David Masterson 2019-04-18 20:33 ` Eric Abrahamsen 0 siblings, 1 reply; 15+ messages in thread From: David Masterson @ 2019-04-17 3:41 UTC (permalink / raw) To: Eric Abrahamsen; +Cc: 35261@debbugs.gnu.org Eric Abrahamsen <eric@ericabrahamsen.net> writes: > Here's what the new version looks like: > > * Getting Started > EBDB is a contact management package: it records information about > people and organizations, and integrates with other Emacs software > packages, mostly those concerned with sending and reading mail. The > principle parts of EBDB are records, which represent people and > organizations; fields, representing detailed data about records; and > databases, which hold and persist records. > > There are a large number of configuration options listed in this > manual, but the only one you might want to tweak in advance is > ~ebdb-sources~ (see [The EBDB Database]), which controls where EBDB > stores its records. > > ** Starting a New Database > If you have no records you want to migrate from other contact > management software, start by calling the command ~ebdb-open~. This > will open a new buffer in ~ebdb-mode~, and prompt you to create a > database, if one doesn't already exist. From there, you can use > {{{kbd(c)}}} to make new records (see [Creating Records]). Otherwise, you'll want to migrate your data from other contact management software as described in the sections below. Currently, EBDB only knows about migrating from BBDB and Org Contacts. ==== Beyond this, I can see that lots of documentation (and, I assume, functionality) is still needed: 1. Installation details of EBDB and related tools. 2. Details on what type of records a database is composed of. 3. Details on the fields of a record. 4. Details on the type of a field. 5. Import/Export functionality 6. Hooks for add-ons * By 'details', I mean some Emacs Elisp and not just English to give us real reference information. -- David ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-17 3:41 ` David Masterson @ 2019-04-18 20:33 ` Eric Abrahamsen 2019-04-19 22:31 ` David Masterson 0 siblings, 1 reply; 15+ messages in thread From: Eric Abrahamsen @ 2019-04-18 20:33 UTC (permalink / raw) To: David Masterson; +Cc: 35261@debbugs.gnu.org On 04/17/19 03:41 AM, David Masterson wrote: > Eric Abrahamsen <eric@ericabrahamsen.net> writes: > >> Here's what the new version looks like: >> >> * Getting Started >> EBDB is a contact management package: it records information about >> people and organizations, and integrates with other Emacs software >> packages, mostly those concerned with sending and reading mail. The >> principle parts of EBDB are records, which represent people and >> organizations; fields, representing detailed data about records; and >> databases, which hold and persist records. >> >> There are a large number of configuration options listed in this >> manual, but the only one you might want to tweak in advance is >> ~ebdb-sources~ (see [The EBDB Database]), which controls where EBDB >> stores its records. >> >> ** Starting a New Database >> If you have no records you want to migrate from other contact >> management software, start by calling the command ~ebdb-open~. This >> will open a new buffer in ~ebdb-mode~, and prompt you to create a >> database, if one doesn't already exist. From there, you can use >> {{{kbd(c)}}} to make new records (see [Creating Records]). > > Otherwise, you'll want to migrate your data from other contact > management software as described in the sections below. Currently, EBDB > only knows about migrating from BBDB and Org Contacts. Okay, sounds good. > ==== > > Beyond this, I can see that lots of documentation (and, I assume, > functionality) is still needed: > > 1. Installation details of EBDB and related tools. > 2. Details on what type of records a database is composed of. > 3. Details on the fields of a record. > 4. Details on the type of a field. > 5. Import/Export functionality > 6. Hooks for add-ons > > * By 'details', I mean some Emacs Elisp and not just English to give us > real reference information. EBDB is only just stabilizing (the export stuff went through some big refactoring just recently) and I'm a little hesitant to lay all this stuff out in the manual. One of the long-term goals is definitely to make EBDB programmable and integratable with other packages, but I'm dragging my feet a little bit until I'm more confident that the API won't change. It'll get there, though. Eric ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-18 20:33 ` Eric Abrahamsen @ 2019-04-19 22:31 ` David Masterson 2019-04-20 0:00 ` Eric Abrahamsen 0 siblings, 1 reply; 15+ messages in thread From: David Masterson @ 2019-04-19 22:31 UTC (permalink / raw) To: Eric Abrahamsen; +Cc: 35261@debbugs.gnu.org Eric Abrahamsen <eric@ericabrahamsen.net> writes: > On 04/17/19 03:41 AM, David Masterson wrote: >> Beyond this, I can see that lots of documentation (and, I assume, >> functionality) is still needed: >> >> 1. Installation details of EBDB and related tools. >> 2. Details on what type of records a database is composed of. >> 3. Details on the fields of a record. >> 4. Details on the type of a field. >> 5. Import/Export functionality >> 6. Hooks for add-ons >> >> * By 'details', I mean some Emacs Elisp and not just English to give us >> real reference information. > > EBDB is only just stabilizing (the export stuff went through some big > refactoring just recently) and I'm a little hesitant to lay all this > stuff out in the manual. One of the long-term goals is definitely to > make EBDB programmable and integratable with other packages, but I'm > dragging my feet a little bit until I'm more confident that the API > won't change. It'll get there, though. Okay. Mostly consider #1 with: * Installation as a package (and via savanah?) * How to get help if needed (bug reports) * Other packages to install/Use (Org and Gnus) A primer as applies to EBDB for #2, #3, and #4 would be nice. ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-19 22:31 ` David Masterson @ 2019-04-20 0:00 ` Eric Abrahamsen 2019-04-21 2:08 ` David Masterson 0 siblings, 1 reply; 15+ messages in thread From: Eric Abrahamsen @ 2019-04-20 0:00 UTC (permalink / raw) To: David Masterson; +Cc: 35261@debbugs.gnu.org, 35261-done On 04/19/19 22:31 PM, David Masterson wrote: > Eric Abrahamsen <eric@ericabrahamsen.net> writes: > >> On 04/17/19 03:41 AM, David Masterson wrote: > >>> Beyond this, I can see that lots of documentation (and, I assume, >>> functionality) is still needed: >>> >>> 1. Installation details of EBDB and related tools. >>> 2. Details on what type of records a database is composed of. >>> 3. Details on the fields of a record. >>> 4. Details on the type of a field. >>> 5. Import/Export functionality >>> 6. Hooks for add-ons >>> >>> * By 'details', I mean some Emacs Elisp and not just English to give us >>> real reference information. >> >> EBDB is only just stabilizing (the export stuff went through some big >> refactoring just recently) and I'm a little hesitant to lay all this >> stuff out in the manual. One of the long-term goals is definitely to >> make EBDB programmable and integratable with other packages, but I'm >> dragging my feet a little bit until I'm more confident that the API >> won't change. It'll get there, though. > > Okay. Mostly consider #1 with: > > * Installation as a package (and via savanah?) > * How to get help if needed (bug reports) > * Other packages to install/Use (Org and Gnus) > > A primer as applies to EBDB for #2, #3, and #4 would be nice. Done! Thanks for all the suggestions. Eric ^ permalink raw reply [flat|nested] 15+ messages in thread
* bug#35261: 26.1; EBDB Documentation 2019-04-20 0:00 ` Eric Abrahamsen @ 2019-04-21 2:08 ` David Masterson 0 siblings, 0 replies; 15+ messages in thread From: David Masterson @ 2019-04-21 2:08 UTC (permalink / raw) To: Eric Abrahamsen; +Cc: 35261@debbugs.gnu.org, 35261-done@debbugs.gnu.org Eric Abrahamsen <eric@ericabrahamsen.net> writes: > Done! Thanks for all the suggestions. :-) ^ permalink raw reply [flat|nested] 15+ messages in thread
end of thread, other threads:[~2019-04-21 2:08 UTC | newest] Thread overview: 15+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2019-04-13 21:26 bug#35261: 26.1; EBDB Documentation David Masterson 2019-04-14 1:50 ` Eric Abrahamsen 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
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).