Skip to content

Commit e315452

Browse files
DavidLiedleclaude
andcommitted
Fix: correct four factual errors found during accuracy review
- Ch. 2: replace obsolete orgmode.org/elpa/ archive with GNU ELPA note - Ch. 5: replace duplicate C-c C-x C-v with correct org-toggle-link-display - Ch. 6: replace non-built-in :DEPENDS: example with :ORDERED: t approach; clarify org-depend.el/org-edna needed for arbitrary cross-task dependencies - Ch. 9: fix :scope nil description from "Current subtree" to "Current buffer (or narrowed region)" Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 0c04688 commit e315452

File tree

4 files changed

+12
-15
lines changed

4 files changed

+12
-15
lines changed

02-getting-started.org

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,12 +43,12 @@ If you last tried Emacs in 1999, prepare to be pleasantly surprised. Modern Emac
4343

4444
Here's the good news: if you're running Emacs 22.1 or later (and you definitely are), Org-Mode is already installed. No package manager wrestling required for basic functionality.
4545

46-
That said, you might want to update to the latest version:
46+
That said, you might want to update to the latest version. Org-mode is available on GNU ELPA, which is included in Emacs by default:
4747

4848
#+begin_src elisp
4949
;; Add to your ~/.emacs or ~/.emacs.d/init.el
5050
(require 'package)
51-
(add-to-list 'package-archives '("org" . "https://orgmode.org/elpa/") t)
51+
(package-initialize)
5252
#+end_src
5353

5454
Then =M-x package-install RET org RET=

05-links-and-images.org

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -302,9 +302,9 @@ The Org manual[fn:1] contains everything, though it's dense[fn::inline footnote
302302

303303
* Link Appearance
304304

305-
By default, links show their description text. To see the underlying link:
305+
By default, links show their description text. To see the underlying link syntax:
306306

307-
- =C-c C-x C-v= - Toggle link display (show raw links vs. descriptions)
307+
- =M-x org-toggle-link-display= - Toggle between showing descriptions and raw link syntax
308308

309309
Useful when editing or debugging links.
310310

06-todo-items.org

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -272,18 +272,15 @@ Why track effort? Because agenda views can show your task load, help plan your d
272272

273273
* Blocking and Dependencies
274274

275-
Some tasks can't start until others finish:
275+
Some tasks can't start until others finish. The built-in approach uses the =:ORDERED:= property on a parent heading:
276276

277277
#+begin_example
278-
* TODO Write code
278+
* TODO Project
279279
:PROPERTIES:
280-
:ID: task-write-code
281-
:END:
282-
283-
* TODO Write tests
284-
:PROPERTIES:
285-
:DEPENDS: task-write-code
280+
:ORDERED: t
286281
:END:
282+
** TODO Write code
283+
** TODO Write tests
287284
#+end_example
288285

289286
Enable blocking:
@@ -292,9 +289,9 @@ Enable blocking:
292289
(setq org-enforce-todo-dependencies t)
293290
#+end_src
294291

295-
Now you can't mark "Write tests" as DONE until "Write code" is complete. Org enforces task order.
292+
Now you can't mark "Write tests" as DONE until "Write code" is complete. Org enforces task order within any heading that has =:ORDERED: t=.
296293

297-
For more complex dependencies, use =org-edna= package. It supports:
294+
For arbitrary dependencies between unrelated tasks (not parent/child), use the contributed =org-depend.el= or the =org-edna= package. Both support:
298295
- Task chains
299296
- Conditional triggers
300297
- Scheduled dependencies

09-clocking-time-tracking.org

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ Boom. Time report. Update anytime with =C-c C-c=.
9292
- =:scope file= - Current file only
9393
- =:scope agenda= - All agenda files
9494
- =:scope subtree= - Current subtree only
95-
- =:scope nil= - Current subtree
95+
- =:scope nil= - Current buffer (or narrowed region)
9696
- =:scope ("file1.org" "file2.org")= - Specific files
9797

9898
*Time range:*

0 commit comments

Comments
 (0)