Skip to content

Commit ba13c87

Browse files
yantar92yantar92
committed
Remove docs from Makefile due to weirt behaviour of emacs in batch mode export
1 parent 0bf688c commit ba13c87

File tree

2 files changed

+86
-90
lines changed

2 files changed

+86
-90
lines changed

‎Makefile

-4
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,5 @@
11
org-autosort: org-autosort.el
22

3-
docs: org-autosort.org
4-
emacs $< --batch -f org-md-export-to-markdown --kill
5-
mv org-autosort.md Readme.md
6-
73
%.elc : %.el
84
rm -f $@
95
emacs -Q --batch --eval '(byte-compile-file "$<")'

‎Readme.md

+86-86
Original file line numberDiff line numberDiff line change
@@ -2,41 +2,41 @@
22
<h2>Table of Contents</h2>
33
<div id="text-table-of-contents">
44
<ul>
5-
<li><a href="#orgfde0f2f">NEXT Automatic sorting of items in org mode</a>
5+
<li><a href="#orgfa26d24">Automatic sorting of items in org mode</a>
66
<ul>
7-
<li><a href="#org9d49615">Motivation</a></li>
8-
<li><a href="#org1f183b3">Overview</a></li>
9-
<li><a href="#orgf01a38b">Configuration</a></li>
10-
<li><a href="#orgc1ba713">Defaults</a></li>
11-
<li><a href="#orgc8acc4a">NEXT Implementation</a>
7+
<li><a href="#orgab593c6">Motivation</a></li>
8+
<li><a href="#orgb3c9acd">Overview</a></li>
9+
<li><a href="#org4703e0d">Configuration</a></li>
10+
<li><a href="#org76c323b">Defaults</a></li>
11+
<li><a href="#org931976d">Implementation</a>
1212
<ul>
13-
<li><a href="#orgebf3f28">Header</a></li>
14-
<li><a href="#orge35a8ef">Custom variables</a></li>
15-
<li><a href="#org946bb28">NEXT Standard sorting functions</a></li>
16-
<li><a href="#orga70a0ee">NEXT [#A] General sorting routine</a></li>
17-
<li><a href="#org06dfd5d">File epilogue</a></li>
13+
<li><a href="#orgb403e90">Header</a></li>
14+
<li><a href="#org6f28c00">Custom variables</a></li>
15+
<li><a href="#orge6485e4">Standard sorting functions</a></li>
16+
<li><a href="#org7749cd9">General sorting routine</a></li>
17+
<li><a href="#orgd9fa159">File epilogue</a></li>
1818
</ul>
1919
</li>
20-
<li><a href="#orga9771e5">NEXT Ideas</a>
20+
<li><a href="#org53d0108">Ideas</a>
2121
<ul>
22-
<li><a href="#orgd216bfc">Sort items when opening org file, on edit??</a></li>
23-
<li><a href="#orgf087718">CANCELLED do not use org-sort, because it does not allow to combine sorts (i.e. sort by one criteria, if equal - by other)</a></li>
24-
<li><a href="#org56a3d4b">allow to define sort criteria like a lisp function in the properties field</a></li>
25-
<li><a href="#org68320c2">Do not sort only but filter items in org files/agenda</a></li>
26-
<li><a href="#orgbcbaafa">CANCELLED Take care about exact position for <code>C-c C-c</code> (say, we are inside the table - user may not want to sort)</a></li>
27-
<li><a href="#org13830c4">Sort only items, matching org search regex</a></li>
28-
<li><a href="#orge7d8182">Handle nothing to sort</a></li>
29-
<li><a href="#orgb7e3fbb">make interactive versions of sorting functions</a></li>
30-
<li><a href="#orgc594c45">autosort - do not sort but show agenda</a></li>
31-
<li><a href="#org7fbf2a5">add hooks to to autosort</a></li>
32-
<li><a href="#org6b02e76">auto add hooks according to the sort type - should be able to define hooks for every sort type</a></li>
33-
<li><a href="#orgff1dff2">get rid of annoying unfolding after <code>org-sort</code></a></li>
34-
<li><a href="#org695d22c">put buffer name in error report for wrong element of sorting strategy</a></li>
35-
<li><a href="#org573e2d9">should be able to define alias in sorting strategy</a></li>
36-
<li><a href="#org5a960e4">NEXT rewrite sorting strategy to use assoc lists</a></li>
37-
<li><a href="#org93a6fdc">use local hook in autosort for toggle hooks</a></li>
38-
<li><a href="#org9d13fc4">add this functionality? Sorting Org Mode lists using a sequence of regular expressions 13</a></li>
39-
<li><a href="#org375ee06">do not raise error but put a message and do not sort on wrong :SORTING: format</a></li>
22+
<li><a href="#org25a0fad">Sort items when opening org file, on edit??</a></li>
23+
<li><a href="#orged315c3">do not use org-sort, because it does not allow to combine sorts (i.e. sort by one criteria, if equal - by other)</a></li>
24+
<li><a href="#orgd8d9485">allow to define sort criteria like a lisp function in the properties field</a></li>
25+
<li><a href="#org149b11c">Do not sort only but filter items in org files/agenda</a></li>
26+
<li><a href="#org6ee0773">Take care about exact position for <code>C-c C-c</code> (say, we are inside the table - user may not want to sort)</a></li>
27+
<li><a href="#org7963246">Sort only items, matching org search regex</a></li>
28+
<li><a href="#org4cfe334">Handle nothing to sort</a></li>
29+
<li><a href="#org34b8873">make interactive versions of sorting functions</a></li>
30+
<li><a href="#org7a7842c">autosort - do not sort but show agenda</a></li>
31+
<li><a href="#org739c797">add hooks to to autosort</a></li>
32+
<li><a href="#org6c0c82d">auto add hooks according to the sort type - should be able to define hooks for every sort type</a></li>
33+
<li><a href="#org511b060">get rid of annoying unfolding after <code>org-sort</code></a></li>
34+
<li><a href="#org3963992">put buffer name in error report for wrong element of sorting strategy</a></li>
35+
<li><a href="#orga8644e5">should be able to define alias in sorting strategy</a></li>
36+
<li><a href="#org47d3284">rewrite sorting strategy to use assoc lists</a></li>
37+
<li><a href="#org2afbd84">use local hook in autosort for toggle hooks</a></li>
38+
<li><a href="#org4af49fe">add this functionality? Sorting Org Mode lists using a sequence of regular expressions 13</a></li>
39+
<li><a href="#orgbb247a6">do not raise error but put a message and do not sort on wrong :SORTING: format</a></li>
4040
</ul>
4141
</li>
4242
</ul>
@@ -46,12 +46,12 @@
4646
</div>
4747

4848

49-
<a id="orgfde0f2f"></a>
49+
<a id="orgfa26d24"></a>
5050

51-
# NEXT Automatic sorting of items in org mode
51+
# Automatic sorting of items in org mode
5252

5353

54-
<a id="org9d49615"></a>
54+
<a id="orgab593c6"></a>
5555

5656
## Motivation
5757

@@ -67,19 +67,19 @@ wish to do one day, or list of ideas). It is not comfortable to scroll
6767
across such kind of list to look for specific item. Sorting is
6868
something, that can help here.
6969

70-
- Add some example here
70+
<div class="inlinetask">
71+
<b>Add some example here</b><br />
72+
nil</div>
7173

72-
- END
74+
Of course, you can still use `org-sort` or agenda view with restriction
75+
to the current subtree, but it may be disrupting if you want to look
76+
through multiple of such a lists.
7377

74-
Of course, you can still use `org-sort` or agenda view with restriction
75-
to the current subtree, but it may be disrupting if you want to look
76-
through multiple of such a lists.
77-
78-
The solution is to implement automatic sorting of subtrees in org
79-
files.
78+
The solution is to implement automatic sorting of subtrees in org
79+
files.
8080

8181

82-
<a id="org1f183b3"></a>
82+
<a id="orgb3c9acd"></a>
8383

8484
## Overview
8585

@@ -95,16 +95,16 @@ subtree). Global sorting order can be set via
9595
`org-autosort-global-sorting-strategy` variable.
9696

9797

98-
<a id="orgf01a38b"></a>
98+
<a id="org4703e0d"></a>
9999

100100
## Configuration
101101

102102
Both `:SORT:` property and `org-autosort-global-sorting-strategy`
103103
are lists, which determine how to sort the entries.
104104

105-
<a id="org0d668fc"></a>
105+
<a id="orga79d54d"></a>
106106
`org-autosort-global-sorting-strategy` defined how to sort entries by
107-
default. It is a list of [sorting rules](#org10b3b9d), defining the comparison
107+
default. It is a list of [sorting rules](#org35fb973), defining the comparison
108108
between sorted entries. First, the entries are sorted via first rule
109109
from the list. If the calculated keys are equal, second rule is used,
110110
and so on.
@@ -123,14 +123,14 @@ The sorting can be done after:
123123
- `org-autosort-sort-entries-at-point` command
124124
- `org-autosort-sort-entries-in-file` command
125125

126-
(see [sorting triggers](#org31dc7e8) for details)
126+
(see [sorting triggers](#orga6cfe20) for details)
127127

128128

129-
<a id="orgc1ba713"></a>
129+
<a id="org76c323b"></a>
130130

131131
## Defaults
132132

133-
The package provide some predefined sorting rules <a id="org10b3b9d"></a>,
133+
The package provide some predefined sorting rules <a id="org35fb973"></a>,
134134
all are listed in `org-autosort-functions-alist`.
135135

136136
(defcustom org-autosort-functions-alist '((todo-up-0 . (:key org-autosort-get-todo :cmp <)) ; default org-sort comparison
@@ -142,8 +142,8 @@ all are listed in `org-autosort-functions-alist`.
142142
;;
143143
(text-up . (:key org-autosort-get:cmp :cmp string<))
144144
(text-down . (:key org-autosort-get-text :cmp string>))
145-
(priority-up . (:key (org-autosort-get-property "PRIORITY") :cmp string<))
146-
(priority-down . (:key (org-autosort-get-property "PRIORITY") :cmp string>)))
145+
(priority-up . (:key (org-autosort-get-property "PRIORITY") :cmp string<))
146+
(priority-down . (:key (org-autosort-get-property "PRIORITY") :cmp string>)))
147147
"Alist, defining aliases to sorting rules.
148148
Each value in the list defines a sorting rule.
149149
The rule is a property list with :key and :cmp properties.
@@ -173,13 +173,13 @@ all are listed in `org-autosort-functions-alist`.
173173
Non nil return value means that first key is lesser than second key."
174174
:type '(function))
175175

176-
You can control automatic sorting by setting <a id="org31dc7e8"></a>
176+
You can control automatic sorting by setting <a id="orga6cfe20"></a>
177177

178178
(defcustom org-autosort-sort-at-file-open t
179179
"Non nil states for sorting of all items in the org file after opening."
180180
:type '(boolean))
181181

182-
Default [sorting strategy](#org0d668fc) is
182+
Default [sorting strategy](#orga79d54d) is
183183

184184
(defcustom org-autosort-global-sorting-strategy '(priority-down todo-up)
185185
"Sorting strategy, used to sort entries with :SORT: property not set or nil.
@@ -194,12 +194,12 @@ Default [sorting strategy](#org0d668fc) is
194194
(list function (repeat sexp))))))
195195

196196

197-
<a id="orgc8acc4a"></a>
197+
<a id="org931976d"></a>
198198

199-
## NEXT Implementation
199+
## Implementation
200200

201201

202-
<a id="orgebf3f28"></a>
202+
<a id="orgb403e90"></a>
203203

204204
### Header
205205

@@ -220,7 +220,7 @@ Default [sorting strategy](#org0d668fc) is
220220
;;; Code:
221221

222222

223-
<a id="orge35a8ef"></a>
223+
<a id="org6f28c00"></a>
224224

225225
### Custom variables
226226

@@ -249,8 +249,8 @@ Default [sorting strategy](#org0d668fc) is
249249
;;
250250
(text-up . (:key org-autosort-get:cmp :cmp string<))
251251
(text-down . (:key org-autosort-get-text :cmp string>))
252-
(priority-up . (:key (org-autosort-get-property "PRIORITY") :cmp string<))
253-
(priority-down . (:key (org-autosort-get-property "PRIORITY") :cmp string>)))
252+
(priority-up . (:key (org-autosort-get-property "PRIORITY") :cmp string<))
253+
(priority-down . (:key (org-autosort-get-property "PRIORITY") :cmp string>)))
254254
"Alist, defining aliases to sorting rules.
255255
Each value in the list defines a sorting rule.
256256
The rule is a property list with :key and :cmp properties.
@@ -295,9 +295,9 @@ Default [sorting strategy](#org0d668fc) is
295295
(list function (repeat sexp))))))
296296

297297

298-
<a id="org946bb28"></a>
298+
<a id="orge6485e4"></a>
299299

300-
### NEXT Standard sorting functions
300+
### Standard sorting functions
301301

302302
- by property
303303

@@ -360,9 +360,9 @@ Default [sorting strategy](#org0d668fc) is
360360
- By any timestamp
361361

362362

363-
<a id="orga70a0ee"></a>
363+
<a id="org7749cd9"></a>
364364

365-
### NEXT [#A] General sorting routine
365+
### General sorting routine
366366

367367
(defun org-autosort-sorting-strategy-elementp (elm)
368368
"Validate element ELM of sorting strategy. Return (:key ... [:cmp ...]) if element and nil otherwise."
@@ -538,7 +538,7 @@ Default [sorting strategy](#org0d668fc) is
538538
(add-hook 'org-mode-hook #'org-autosort-sort-entries-in-file-maybe)
539539

540540

541-
<a id="org06dfd5d"></a>
541+
<a id="orgd9fa159"></a>
542542

543543
### File epilogue
544544

@@ -547,97 +547,97 @@ Default [sorting strategy](#org0d668fc) is
547547
;;; org-autosort.el ends here
548548

549549

550-
<a id="orga9771e5"></a>
550+
<a id="org53d0108"></a>
551551

552-
## NEXT Ideas
552+
## Ideas
553553

554554

555-
<a id="orgd216bfc"></a>
555+
<a id="org25a0fad"></a>
556556

557557
### Sort items when opening org file, on edit??
558558

559559

560-
<a id="orgf087718"></a>
560+
<a id="orged315c3"></a>
561561

562-
### CANCELLED do not use org-sort, because it does not allow to combine sorts (i.e. sort by one criteria, if equal - by other)
562+
### do not use org-sort, because it does not allow to combine sorts (i.e. sort by one criteria, if equal - by other)
563563

564564

565-
<a id="org56a3d4b"></a>
565+
<a id="orgd8d9485"></a>
566566

567567
### allow to define sort criteria like a lisp function in the properties field
568568

569569

570-
<a id="org68320c2"></a>
570+
<a id="org149b11c"></a>
571571

572572
### Do not sort only but filter items in org files/agenda
573573

574574

575-
<a id="orgbcbaafa"></a>
575+
<a id="org6ee0773"></a>
576576

577-
### CANCELLED Take care about exact position for `C-c C-c` (say, we are inside the table - user may not want to sort)
577+
### Take care about exact position for `C-c C-c` (say, we are inside the table - user may not want to sort)
578578

579579

580-
<a id="org13830c4"></a>
580+
<a id="org7963246"></a>
581581

582582
### Sort only items, matching org search regex
583583

584584

585-
<a id="orge7d8182"></a>
585+
<a id="org4cfe334"></a>
586586

587587
### Handle nothing to sort
588588

589589

590-
<a id="orgb7e3fbb"></a>
590+
<a id="org34b8873"></a>
591591

592592
### make interactive versions of sorting functions
593593

594594

595-
<a id="orgc594c45"></a>
595+
<a id="org7a7842c"></a>
596596

597597
### autosort - do not sort but show agenda
598598

599599

600-
<a id="org7fbf2a5"></a>
600+
<a id="org739c797"></a>
601601

602602
### add hooks to to autosort
603603

604604

605-
<a id="org6b02e76"></a>
605+
<a id="org6c0c82d"></a>
606606

607607
### auto add hooks according to the sort type - should be able to define hooks for every sort type
608608

609609

610-
<a id="orgff1dff2"></a>
610+
<a id="org511b060"></a>
611611

612612
### get rid of annoying unfolding after `org-sort`
613613

614614

615-
<a id="org695d22c"></a>
615+
<a id="org3963992"></a>
616616

617617
### put buffer name in error report for wrong element of sorting strategy
618618

619619

620-
<a id="org573e2d9"></a>
620+
<a id="orga8644e5"></a>
621621

622622
### should be able to define alias in sorting strategy
623623

624624

625-
<a id="org5a960e4"></a>
625+
<a id="org47d3284"></a>
626626

627-
### NEXT rewrite sorting strategy to use assoc lists
627+
### rewrite sorting strategy to use assoc lists
628628

629629

630-
<a id="org93a6fdc"></a>
630+
<a id="org2afbd84"></a>
631631

632632
### use local hook in autosort for toggle hooks
633633

634634

635-
<a id="org9d13fc4"></a>
635+
<a id="org4af49fe"></a>
636636

637637
### add this functionality? [Sorting Org Mode lists using a sequence of regular expressions 13](http://sachachua.com/blog/2017/12/sorting-org-mode-lists-using-a-sequence-of-regular-expressions/)
638638

639639

640-
<a id="org375ee06"></a>
640+
<a id="orgbb247a6"></a>
641641

642642
### do not raise error but put a message and do not sort on wrong :SORTING: format
643643

0 commit comments

Comments
 (0)