summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorKyle Meyer <kyle@kyleam.com>2014-06-05 01:06:57 -0400
committerKyle Meyer <kyle@kyleam.com>2014-06-05 01:06:57 -0400
commit8dd0b11cedd59f140e354bbf3d7238b84d14cebc (patch)
tree36f08d37a97ba064100fabc004c0154cf1ae8b82 /README.md
parent874bb06cd67a92fdf0f420221d6954e72e614bb5 (diff)
downloadbog-8dd0b11cedd59f140e354bbf3d7238b84d14cebc.tar.gz
README rephrasing
Diffstat (limited to 'README.md')
-rw-r--r--README.md14
1 files changed, 8 insertions, 6 deletions
diff --git a/README.md b/README.md
index 246812d..bda9ed4 100644
--- a/README.md
+++ b/README.md
@@ -20,10 +20,12 @@ The Bog workflow is focused around the citekey, which is the only study
information that must be included in the notes. This unique identifier
is used as a link to the BibTeX file and other associated files.
-In the example below, the citekey "name2000word" is a study heading. Bog
-expects the citekey to be the title or property of a heading. The
-citekey "another1999study" is a reference to another study (which may or
-may not have a subtree in this or another Org file).
+In the example below, the citekey "name2000word" is a study heading. A
+study heading is defined as a heading the has a citekey as a title or as
+the value of `bog-citekey-property`. When a citekey occurs anywhere else
+(like "another1999study" below), they are taken as a reference to
+another study (which may or may not have a subtree in this or another
+Org file).
* Topic heading
@@ -48,8 +50,8 @@ settings can be modified.
Many Bog functions take the citekey from the notes. If the point is on a
citekey (like "another1999study" above), then that citekey will be used.
-Otherwise, the citekey will be taken from the first parent heading that
-is a study (if that makes sense for the given function).
+If this fails, many functions will try to take the citekey from the
+first parent heading that is a study heading.
- `bog-find-citekey-file`
Open an associated file for a citekey.