-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathorg-faq.html
6799 lines (5796 loc) · 311 KB
/
org-faq.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2021-06-15 Tue 18:23 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Org-mode Frequently Asked Questions</title>
<meta name="generator" content="Org mode" />
<meta name="author" content="Worg people" />
<link rel="stylesheet" type="text/css" href="src/readtheorg_theme/css/htmlize.css"/>
<link rel="stylesheet" type="text/css" href="src/readtheorg_theme/css/readtheorg.css"/>
<script type="text/javascript" src="src/lib/js/jquery.min.js"></script>
<script type="text/javascript" src="src/lib/js/bootstrap.min.js"></script>
<script type="text/javascript" src="src/lib/js/jquery.stickytableheaders.min.js"></script>
<script type="text/javascript" src="src/readtheorg_theme/js/readtheorg.js"></script>
<script type="text/javascript">
// @license magnet:?xt=urn:btih:1f739d935676111cfff4b4693e3816e664797050&dn=gpl-3.0.txt GPL-v3-or-Later
<!--/*--><![CDATA[/*><!--*/
function CodeHighlightOn(elem, id)
{
var target = document.getElementById(id);
if(null != target) {
elem.cacheClassElem = elem.className;
elem.cacheClassTarget = target.className;
target.className = "code-highlighted";
elem.className = "code-highlighted";
}
}
function CodeHighlightOff(elem, id)
{
var target = document.getElementById(id);
if(elem.cacheClassElem)
elem.className = elem.cacheClassElem;
if(elem.cacheClassTarget)
target.className = elem.cacheClassTarget;
}
/*]]>*///-->
// @license-end
</script>
</head>
<body>
<div id="org-div-home-and-up">
<a accesskey="h" href="index.html"> UP </a>
|
<a accesskey="H" href="https://orgmode.org/worg/"> HOME </a>
</div><div id="content">
<h1 class="title">Org-mode Frequently Asked Questions</h1>
<div id="table-of-contents">
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#org31e39e9">Is my question already a Frequently Asked Questions ?</a></li>
<li><a href="#What-is-org-mode">What is org-mode?</a>
<ul>
<li><a href="#can-org-do-x">Can Org-mode do “x”? Does org have “x” feature?</a></li>
<li><a href="#GTD-workflow-with-Org-mode">Can I implement a GTD workflow with Org-mode?</a></li>
<li><a href="#Org-and-TaskPaper">What is the difference between Org and TaskPaper?</a></li>
<li><a href="#unicorn">What is the meaning of the Unicorn on Org’s website?</a></li>
<li><a href="#orgee94c8d">Is Org’s documentation written in Org?</a></li>
<li><a href="#orgfb4ca8c">Is there a bibtex entry for the Org manual?</a></li>
</ul>
</li>
<li><a href="#orgb5fb61f">Mailing list</a>
<ul>
<li><a href="#bug-reporting">I think my Org-mode is broken! How do I report a bug?</a></li>
<li><a href="#ecm">What is an “ECM”?</a></li>
<li><a href="#when-to-contact-mailing-list">What should I do before contacting the mailing list?</a></li>
<li><a href="#ml-post-delay">Why hasn’t my email to the mailing list shown up yet?</a></li>
<li><a href="#ml-subscription-and-gmane">I read the mailing list through gmane. Should I subscribe?</a></li>
</ul>
</li>
<li><a href="#Keeping-current">Keeping current</a>
<ul>
<li><a href="#new-exporter-switch">Upgrading to Org 8.0/master and using the new export engine</a></li>
<li><a href="#updating-org">My Emacs ships with an older version Org-mode! How do I upgrade?</a></li>
<li><a href="#keeping-current-with-Org-mode-development">How do I keep current with bleeding edge development?</a></li>
<li><a href="#update-info-manual-to-latest">How do I update the info manual pages to the latest org-mode version?</a></li>
<li><a href="#keeping-local-changes-current-with-Org-mode-development">How can I keep local changes and still track Org-mode development?</a></li>
<li><a href="#using-stable-releases-only">How can I use a stable release version instead of the bleeding edge master?</a></li>
<li><a href="#installing-org-without-make-tools">How can I install an up-to-date version of org-mode without “make” tools?</a></li>
<li><a href="#org5e4614c">I don’t use git. Can I download bleeding edge .zip and .tar.gz archives?</a></li>
<li><a href="#installing-via-elpa">How do I install Org-mode through Emacs’ Package Manager?</a></li>
<li><a href="#installing-elpa">How do I install Emacs package manager?</a></li>
<li><a href="#why-no-org-in-elpa">I don’t see Org-mode as an installation option in Package Manager Menu?</a></li>
<li><a href="#installing-from-elpa-tarball">How do I install Org-mode from a ELPA-compatible tarball?</a></li>
<li><a href="#why-elpa">Why would I use ELPA tarballs instead of the snapshot tarballs?</a></li>
</ul>
</li>
<li><a href="#Setup">Setup</a>
<ul>
<li><a href="#org2271276">How can I quickly browse all Org options?</a></li>
<li><a href="#use-editing-features-in-other-modes">Can I use the editing features of org-mode in other modes?</a></li>
<li><a href="#making-sure-org-mode-is-up-to-date">Why isn’t feature “X” working the way it is described in the manual?</a></li>
<li><a href="#orgc7eef05">Can I get the visibility-cycling features in emacs-lisp-mode?</a></li>
<li><a href="#use-visibility-cycling-in-outline-mode">Can I get the visibility-cycling features in outline-mode and outline-minor-mode?</a></li>
<li><a href="#saving-visibility-state">Can I save and restore the visibility state of an org-mode buffer?</a></li>
<li><a href="#track-of-changes-in-Org-files">How can I keep track of changes in my Org files?</a></li>
<li><a href="#Org-mode-as-default-mode">Can I use Org-mode as the default mode for all README files?</a></li>
<li><a href="#ido-complete">Can I use ido.el for completing stuff in Org?</a></li>
<li><a href="#how-to-organize-org-mode-files">Should I use one big org file or multiple files?</a></li>
<li><a href="#setting-global-keybindings">Why doesn’t C-c a call the agenda? Why don’t some org keybindings work?</a></li>
<li><a href="#load-org-after-setting-variables">Why aren’t some of the variables I’ve customized having an effect?</a></li>
<li><a href="#timestamps-and-system-time-locale">How can I make sure that timestamps appear in English?</a></li>
<li><a href="#minimal-emacs">What does a minimal .emacs look like?</a></li>
<li><a href="#indentation">What is the best setup for indenting?</a></li>
<li><a href="#orgf3b787f">Can I migrate from Planner?</a></li>
</ul>
</li>
<li><a href="#Errors">Errors and general problems</a>
<ul>
<li><a href="#mixed-install">Is my Orgmode installation mixed?</a></li>
<li><a href="#Emacs-crashes-with-org-indent-mode">Opening Org files in Emacs leads to a crash</a></li>
<li><a href="#wrong-type-argument-keymapp">When I try to use Org-mode, I always get the error message <code>(wrong-type-argument keymapp nil)</code></a></li>
<li><a href="#external-application-launched-to-open-file-link">How can I control the application launched by Org-mode to open a certain file type like pdf, html…?</a></li>
<li><a href="#YASnippet">Org-mode takes over the TAB key. I also want to use YASnippet, is there a way to fix this conflict?</a></li>
<li><a href="#CUA-mode">Org-mode takes over the S-cursor keys. I also want to use CUA-mode, is there a way to fix this conflict?</a></li>
<li><a href="#windmove.el">Org-mode takes over the S-cursor keys. I also want to use windmove.el, is there a way to fix this conflict?</a></li>
<li><a href="#loaded-old-org">Org behaves strangely: some keys don’t work, some features are missing, my settings have no effect, …</a></li>
<li><a href="#org-batch-agenda-under-win32">Why doesn’t org-batch-agenda work under Win32?</a></li>
<li><a href="#slow-agenda">Org agenda seems very slow</a></li>
<li><a href="#visual-line-mode">Visual-line-mode doesn’t work well with Org-mode</a></li>
<li><a href="#org3a2ee11">Can I hide blocks at startup?</a></li>
<li><a href="#invalid-function-error">After updating Org I get an error about an <code>invalid function</code></a></li>
<li><a href="#org0d549f1">I use starter-kit and I get an error <code>(void-function org-pop-to-buffer-same-window)</code></a></li>
<li><a href="#org52424b7">(Filling a paragraph|Indenting a list|…) behaves strangely</a></li>
</ul>
</li>
<li><a href="#Faces">Faces and highlighting</a>
<ul>
<li><a href="#customizing-org-faces">Org-mode has a lot of colors? How can I change them?</a></li>
<li><a href="#column-view-tiny-font">Why do I get a tiny font in column view when using emacs daemon?</a></li>
<li><a href="#ratpoison-for-agenda-highlighting">How can I stop the mouse cursor from highlighting lines in the agenda?</a></li>
</ul>
</li>
<li><a href="#Outline">Outline</a>
<ul>
<li><a href="#closing-outline-sections">Can I close an outline section without starting a new section?</a></li>
<li><a href="#list-item-as-todo">Can I add a TODO to a list item?</a></li>
<li><a href="#indirect-buffers">Can I have two windows on the same Org-mode file, with different outline visibilities?</a></li>
<li><a href="#Emacs-outlines-are-unreadable">Emacs outlines are unreadable. Can I get rid of all those stars?</a></li>
<li><a href="#C-k-is-killing-subtrees">C-k is killing whole subtrees! I lost my work!</a></li>
<li><a href="#transient-mark-mode">Why aren’t commands working on regions?</a></li>
<li><a href="#blank-line-after-headlines-and-list-items">Why is a blank line inserted after headlines and list items?</a></li>
<li><a href="#demote-multiple-headlines">How can I promote or demote multiple headlines at once?</a></li>
<li><a href="#org-ellipses">What’s the deal with all the ellipses in my org outlines?</a></li>
<li><a href="#yank-indent-subtree">How do I yank a subtree so it’s indented according to the point’s location?</a></li>
<li><a href="#org-outlines-in-vim">Can I read org-mode outlines in vim?</a></li>
<li><a href="#org0f0e7f3">Can I use another character than “*” to start a headline?</a></li>
</ul>
</li>
<li><a href="#Todos-and-Tags">Todos and Tags</a>
<ul>
<li><a href="#orgf52aacf">How can I automatically archive canceled tasks?</a></li>
<li><a href="#cycle-TODO-keywords">How can I cycle through the TODO keyword of an entry?</a></li>
<li><a href="#track-state-changes-for-tasks">How do I track state changes for tasks in Org?</a></li>
<li><a href="#select-TODO-keywords-with-tag-like-interface">Can I select the TODO keywords with a tag-like interface?</a></li>
<li><a href="#quickly-set-tag-of-entry">How can I quickly set the tag of an entry?</a></li>
<li><a href="#orgd690d4e">How can I change the colors of TODO keywords?</a></li>
<li><a href="#orga58daea">Can I use a arbitrary character in a TODO keyword?</a></li>
<li><a href="#org19404c9">How do I arrange for an item to be automatically marked DONE when all checkboxes are checked?</a></li>
</ul>
</li>
<li><a href="#Hyperlinks">Hyperlinks</a>
<ul>
<li><a href="#confirm-shell/elisp-link">Why do I have to confirm the execution of each shell/elisp link?</a></li>
<li><a href="#RET-or-TAB-to-follow-link">Can I use RET or TAB to follow a link?</a></li>
<li><a href="#mouse-1-following-link">Can I keep mouse-1 clicks from following a link?</a></li>
<li><a href="#completion-of-file-links">How can I get completion of file names when creating a link?</a></li>
<li><a href="#invisible-targets-in-lists">How can I use invisible targets within lists?</a></li>
<li><a href="#mailto-links">Org-mode is not opening mailto links in my default mail client</a></li>
<li><a href="#CamelCase-links">Can I use CamelCase links?</a></li>
<li><a href="#org4fa7f69">Can I create links to Thunderbirds emails?</a></li>
</ul>
</li>
<li><a href="#Plain-Lists">Plain Lists</a>
<ul>
<li><a href="#empty-line-before-each-new-headline-but-not-item">How can I insert an empty line before each newly inserted headline, but not before each newly inserted plain-list item?</a></li>
<li><a href="#convert-itemized-to-enumerated-lists">How can I convert itemized lists to enumerated lists?</a></li>
<li><a href="#convert-plain-lists-to-headlines">How can I convert plain lists to headlines and vice versa?</a></li>
<li><a href="#description-lists">Is there a good way to create a description list?</a></li>
<li><a href="#org161f3d3">How can I export alphabetical lists to… alphabetical lists?</a></li>
</ul>
</li>
<li><a href="#Tables">Tables</a>
<ul>
<li><a href="#table-multiline-fields">Will there ever be support for multiple lines in a table field?</a></li>
<li><a href="#table-alignment-asian-characters">How can I make table alignment work with Asian character sets</a></li>
<li><a href="#plotting-table-data">Can I plot data from a table?</a></li>
<li><a href="#fill-table-column-with-incremental-numbers">How can I fill a table column with incremental numbers?</a></li>
<li><a href="#S-RET-in-a-table-increases-copied-numbers"><code>S-RET</code> in a table keeps increasing the copied numbers. How can I stop this?</a></li>
<li><a href="#table-column-filled-with-ERROR">Why does my table column get filled with #ERROR?</a></li>
<li><a href="#table-editor-creates-new-lines">How can I stop the table editor from creating new lines?</a></li>
<li><a href="#table-fields-starting-with-=">How can I get table fields starting with “=”?</a></li>
<li><a href="#table-fields-with-vertical-bar">How can I get a vertical bar “|” inside a table field?</a></li>
<li><a href="#change-indentation-entire-table">How can I change the indentation of an entire table without fixing every line by hand?</a></li>
<li><a href="#table-realigning-after-TAB-takes-long">In my huge table the realigning after each TAB takes too long. What can I do?</a></li>
<li><a href="#Recalculation-of-my-table-takes-too-long">Recalculation of my table takes too long. What can I do?</a></li>
<li><a href="#table-borders-in-html-export">When I export tables to HTML, they don’t have borders.</a></li>
<li><a href="#table-high-precision">Why does the Calc high precision (e. g. <code>p20</code>) not work like expected?</a></li>
<li><a href="#table-float-fraction">Which float format shows the fraction part also when the latter is zero?</a></li>
<li><a href="#orgf8d4054">How can I center tables in LaTeX output?</a></li>
<li><a href="#org6e21e7c">Can I exclude columns from a table when exporting it?</a></li>
</ul>
</li>
<li><a href="#Footnotes">Markup</a>
<ul>
<li><a href="#footnote-auto-adjust">How can I get automatic renumbering of footnotes in org-mode?</a></li>
<li><a href="#why-no-default-auto-adjust">Why isn’t auto renumbering of footnotes turned on by default?</a></li>
<li><a href="#auto-fill-and-unwanted-comments">I have auto-fill-mode set and org-mode is inserting unwanted comment markers!</a></li>
<li><a href="#shortcuts-for-entering-source-blocks">Are there any shortcuts for entering source blocks and comment lines?</a></li>
</ul>
</li>
<li><a href="#Remember">Capture and remember</a>
<ul>
<li><a href="#variable-inside-capture-templates">Can I use a variable or a function inside the `org-capture-templates’ variable?</a></li>
<li><a href="#use-remember-buffer-to-clock-phone-call">Can I use the remember buffer to clock a customer phone call?</a></li>
<li><a href="#start-clock-when-opening-remember-template">Can I automatically start the clock when opening a remember template?</a></li>
</ul>
</li>
<li><a href="#Searches">Searches</a>
<ul>
<li><a href="#isearch-in-links">Isearch does not find string hidden in links. What can I do?</a></li>
<li><a href="#context-in-sparse-trees">How can I reduce the amount of context shown in sparse trees?</a></li>
<li><a href="#two-calls-to-org-occur">How can I combine the results of two calls to <code>org-occur</code>?</a></li>
</ul>
</li>
<li><a href="#Agenda">Agenda</a>
<ul>
<li><a href="#orgf65a7a0">My agenda commands are slow. What to do?</a></li>
<li><a href="#warning-period-for-deadlines">How can I change the advanced warning time for deadlines?</a></li>
<li><a href="#deferring-tasks">How can I postpone a task until a certain date?</a></li>
<li><a href="#email-containing-tasks-or-other-agenda-info">Can I send myself an email containing tasks or other agenda info?</a></li>
<li><a href="#limit-agenda-with-tag-filtering">How can I limit the agenda view to my “work” tasks?</a></li>
<li><a href="#limit-agenda-with-category-match">How can I limit the agenda view to a particular category?</a></li>
<li><a href="#set-agenda-files-using-wildcards">How can include all org files in a directory in my agenda?</a></li>
<li><a href="#removing-done-items-from-agenda">Why aren’t items disappearing from my agenda once they are marked done?</a></li>
<li><a href="#repeating-timestamps-show-once">How do I keep repeating timestamps from being displayed multiple times?</a></li>
<li><a href="#scheduled-vs-deadline-vs-timestamp">What is the difference between SCHEDULED, DEADLINE, and plain timestamps?</a></li>
<li><a href="#set-agenda-files-recursively">Can I add files recursively to my list of agenda files?</a></li>
<li><a href="#agenda-wrong-time-of-day">Why does an item appearing at the wrong time of day in my agenda?</a></li>
<li><a href="#cycling-visibility-from-agenda">How can I change the visibility of an item from the agenda?</a></li>
<li><a href="#org2f9ef9c">Is there any way to set org-mode so that tags don’t appear in the agenda view?</a></li>
<li><a href="#org-extend-today-until">I work late at night! How can I extend my current day past midnight?</a></li>
<li><a href="#org9de8c21">How can I let a task repeat until a certain date?</a></li>
</ul>
</li>
<li><a href="#Appointments/Diary">Appointments/Diary</a>
<ul>
<li><a href="#include-entries-from-org-mode-files-into-emacs-diary">Is it possible to include entries from org-mode files into my emacs diary?</a></li>
<li><a href="#add-Org-scheduled/deadlined-entries-to-diary!">I want to add my Org scheduled/deadlined entries in my diary!</a></li>
<li><a href="#automatic-reminders">How can I set up automatic reminders based on Org information?</a></li>
<li><a href="#appt-notice-my-Org-appointments">How can I make <code>appt</code> notice my Org appointments?</a></li>
<li><a href="#diary-sexp-in-org-files">How can I create more complex appointments in my org-files?</a></li>
<li><a href="#org-class">How can I schedule a weekly class that lasts for a limited period of time?</a></li>
<li><a href="#orgd4702e8">How can I set an event to occur every day except Saturday and Sunday?</a></li>
<li><a href="#orgb694184">How do I schedule events relative to Easter Sunday?</a></li>
<li><a href="#orgb69e62a">How to schedule public holiday that is “the nearest Monday to DATE”?</a></li>
<li><a href="#orgdddb9b4">How to schedule public holiday on “the 4th Monday in October”?</a></li>
<li><a href="#orga557a7a">Why isn’t the agenda showing all the times I put under a single entry?</a></li>
<li><a href="#orgeaee5aa">Can I import iCal events/appts from Gnus?</a></li>
</ul>
</li>
<li><a href="#Export">Export</a>
<ul>
<li><a href="#org7640fff">How do I ignore a headline?</a></li>
<li><a href="#beamer-backwards-incompatibility">My old beamer presentations does not look the same with <code>ox-beamer.el</code></a></li>
<li><a href="#filter">How can I export <my favourite element> as <my favourite environment> or how can I transform the export output using filters</a></li>
<li><a href="#export-TODO-items-as-lists">Can I get TODO items exported to HTML as lists, rather than as headlines?</a></li>
<li><a href="#export-single-subtree">Can I export only a single subtree?</a></li>
<li><a href="#export-options-for-subtree">How can I customize export options for a single subtree?</a></li>
<li><a href="#orgc88b516">How can I tell my calendar web application about appointments in my agenda files?</a></li>
<li><a href="#iCal-import-ics-files-old">How can I get Mac OSX 10.3 iCal to import my org-exported .ics files?</a></li>
<li><a href="#iCal-import-ics-files-new">How can I get Mac OSX 10.4 or later iCal to import my Org-exported .ics files?</a></li>
<li><a href="#export-options-remove-timestamps">How can I remove timestamps and todo keywords from my exported file?</a></li>
<li><a href="#preserving-faces-during-batch-export">How can I preserve faces when I export an agenda from the command line?</a></li>
<li><a href="#avoiding-dark-background-when-exporting-agenda">How can I avoid dark color background when exporting agenda to ps format?</a></li>
<li><a href="#include-abstract-in-export-to-latex-and-html">How can I include e.g. an abstract in export to Latex and HTML?</a></li>
<li><a href="#fontified_source_code_w_latex">How can I get colored source code when exporting to LaTeX?</a></li>
<li><a href="#beamer">How can I export to Latex Beamer?</a></li>
<li><a href="#using-reftex-in-org-mode">How can I use RefTeX in Org-mode files for LaTeX export and in Org-babel LaTeX code blocks?</a></li>
<li><a href="#using-xelatex-for-pdf-export">How can I use XeLaTeX for LaTeX export instead of pdfLaTeX?</a></li>
<li><a href="#unreadable-pdfs">Why is my exported PDF file almost unreadable?</a></li>
<li><a href="#html-image-and-link-attributes">Can I add attributes to a link or an image in HTML export?</a></li>
<li><a href="#convert-to-open-office">How can I export an org file to rtf, odt (Open Office), or doc (Word)?</a></li>
<li><a href="#org4c29db3">ODT export aborts on my Windows machine as I don’t have zip installed. Where can I find a zip utility?</a></li>
<li><a href="#debugging-org-odt">I cannot open an exported <code>*.odt</code> file in LibreOffice because it is corrupt. What do I do?</a></li>
<li><a href="#orgf3b5d83">How can I specify ODT export styles?</a></li>
<li><a href="#orga03bdee">Can I omit the title in the LaTeX export?</a></li>
<li><a href="#org7afcca1">How can I use arbitrary colors for words/sentences in HTML export?</a></li>
<li><a href="#org5cf3ba1">How can I suppress the page number in the footer of an exported PDF?</a></li>
</ul>
</li>
<li><a href="#org1c7d92e">Backup</a></li>
<li><a href="#org649b3b1">Org-mode on mobile devices</a>
<ul>
<li><a href="#orgfb90221">What mobile apps for org-mode are available?</a></li>
<li><a href="#org7453541">Can I use the same files on my mobile device as on my computer?</a></li>
</ul>
</li>
<li><a href="#orgdac7ffd">Mathjax</a>
<ul>
<li><a href="#install_mathjax_on_server">How to install MathJax on my server?</a></li>
</ul>
</li>
<li><a href="#orga3b6040">Tips and Tricks</a>
<ul>
<li><a href="#org9dbd302">Can I create an Org link from a gmail email?</a></li>
<li><a href="#Problems-with-LaTeX-macros-with-#+latex-or-#+begin_latex">Problems with LaTeX macros with #+latex or #+begin_latex</a></li>
<li><a href="#orgfd8ce81">Inserting a Mairix type link when calling Orgmode capture in VM</a></li>
<li><a href="#org97aae3e">Can I prevent ispell from checking source blocks?</a></li>
<li><a href="#orge460bfc">Can I archive a subtree while keeping its hiearchy above?</a></li>
</ul>
</li>
<li><a href="#GSoC">Google Summer of Code (GSoC)</a>
<ul>
<li><a href="#GSoC-2012">Does Org Mode participate in GNU’s application for the GSoC 2012?</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div id="outline-container-org31e39e9" class="outline-2">
<h2 id="org31e39e9">Is my question already a Frequently Asked Questions ?</h2>
<div class="outline-text-2" id="text-org31e39e9">
<p>
You can find answers by asking on the mailing list, but people will
probably direct you here, so it is safer to start by checking this
FAQ.
</p>
</div>
</div>
<div id="outline-container-What-is-org-mode" class="outline-2">
<h2 id="What-is-org-mode">What is org-mode?</h2>
<div class="outline-text-2" id="text-What-is-org-mode">
</div>
<div id="outline-container-can-org-do-x" class="outline-3">
<h3 id="can-org-do-x">Can Org-mode do “x”? Does org have “x” feature?</h3>
<div class="outline-text-3" id="text-can-org-do-x">
<p>
In its default setup, Org-mode offers a simple outlining and task
management environment. But it also has a huge number of features and
settings “under the hood.” Advanced users have configured Org-mode for
almost every conceivable use scenario.
</p>
<p>
Org-mode has a very active community and rich and extensive
documentation. Before emailing the mailing list to ask whether
Org-mode has a particular feature or setting, please consult the
following:
</p>
<ul class="org-ul">
<li>Read/search the manual.
<ul class="org-ul">
<li><a href="https://orgmode.org/manual/index.html">https://orgmode.org/manual/index.html</a>
<ul class="org-ul">
<li>Make sure to check out the following indexes:
<ul class="org-ul">
<li><a href="https://orgmode.org/manual/Main-Index.html#Main-Index">Main Index</a></li>
<li><a href="https://orgmode.org/manual/Key-Index.html#Key-Index">Key Index</a></li>
<li><a href="https://orgmode.org/manual/Variable-Index.html#Variable-Index">Variable Index</a></li>
</ul></li>
</ul></li>
<li><p>
The manual is also easily available from within emacs.
</p>
<p>
To read the manual within emacs, you can evaluate <code>(info
"(org)")</code> within emacs—i.e., type <code>C-x C-e</code> after the closing
paragraph of the info expression above.
</p>
<p>
You can also type <code>M-x info</code> and navigate to “Org Mode”.
</p>
<p>
You can search the entire manual by typing <code>C-s term</code>. Keep
pressing <code>C-s</code> to cycle through the results
</p></li>
</ul></li>
<li><p>
Search the mailing list archives at <a href="http://lists.gnu.org/archive/html/emacs-orgmode/">lists.gnu.org</a> or
<a href="https://orgmode.org/list/">orgmode.org/list</a>.
</p>
<p>
There is a good chance that the feature you are looking for has
already been discussed (most likely several times).
</p></li>
<li>Check for features from within emacs.
<ul class="org-ul">
<li>Emacs has a wonderful built-in help system.</li>
<li>You can browse (and change) most customization options by typing
<code>M-x org-customize</code>.</li>
<li>You can check for a feature by typing <code>M-x apropos [RET] [word]</code> or
<code>C-h a word</code>. This will search for all functions and variables
matching the term (or regexp) you enter.</li>
<li><p>
You can browse (and search for) org functions, variables, and
faces by using <code>M-x describe-variable</code> (<code>C-h v</code>), <code>M-x
describe-function</code> (<code>C-h f</code>), or <code>M-x describe-face</code>.
</p>
<p>
After invoking one of these commands, simply type <code>org-[TAB]</code> to
see a full list of relevant functions or variables or faces. You
can then drill down further: e.g., <code>org-export-[TAB]</code> for export
features.
</p></li>
</ul></li>
<li><p>
Checkout the <a href="org-tutorials/index.html">tutorials on Worg</a>.
</p>
<p>
Several of these tutorials discuss advanced features (e.g.,
searching, custom agenda commands, tables, publishing) of Org-mode
in depth.
</p>
<p>
There are many other resources on Worg as well:
</p>
<dl class="org-dl">
<dt><a href="https://orgmode.org/worg/org-configs/index.html">Org Customization</a></dt><dd>Includes a guide for beginners.</dd>
<dt><a href="https://orgmode.org/worg/org-hacks.html">Org Hacks</a></dt><dd>User-generated modifications and add-ons.</dd>
<dt><a href="https://orgmode.org/worg/org-glossary.html">Org Glossary</a></dt><dd>An explanation of basic Org-mode terms and
concepts.</dd>
</dl></li>
</ul>
</div>
</div>
<div id="outline-container-GTD-workflow-with-Org-mode" class="outline-3">
<h3 id="GTD-workflow-with-Org-mode">Can I implement a GTD workflow with Org-mode?</h3>
<div class="outline-text-3" id="text-GTD-workflow-with-Org-mode">
<p>
Yes, you can. Check for discussions and pointers <a href="https://orgmode.org/worg/org-gtd-etc.html">here</a>.
</p>
</div>
</div>
<div id="outline-container-Org-and-TaskPaper" class="outline-3">
<h3 id="Org-and-TaskPaper">What is the difference between Org and TaskPaper?</h3>
<div class="outline-text-3" id="text-Org-and-TaskPaper">
<p>
There is really no difference. Org is as <i>simple</i> as <a href="http://hogbaysoftware.com/products/taskpaper">TaskPaper</a>. It
is just that, when using Org within Emacs, it lets you do many things
that you wouldn’t be able to do with TaskPaper. Yes, TaskPaper is
fiddle-proof and people using Emacs tends to like fiddling (which is
orthogonal to the idea of using todo-lists efficiently), but this is
just a matter of discipline and common sense, not one of Org’s design.
</p>
<p>
Read <a href="https://orgmode.org/list/[email protected]">Carsten’s enlightening statement</a> on this.
</p>
</div>
</div>
<div id="outline-container-unicorn" class="outline-3">
<h3 id="unicorn">What is the meaning of the Unicorn on Org’s website?</h3>
<div class="outline-text-3" id="text-unicorn">
<p>
The Unicorn is the logo of Org-mode because:
</p>
<ul class="org-ul">
<li>Org-mode is the UNICs of ORgaNizers.</li>
<li>Org-mode is an Emacs mode, so it makes sense to use an animal
similar or related to the gnu used for GNU Emacs.</li>
<li>Org-mode is meant to show you the way, and an animal with two horns
can not do this very well, can it?</li>
<li>Unicorn tears are said to reverse petrification, and wasn’t this how
we all felt before getting to some degree of time and task
management?</li>
<li>It will take forever to learn everything there is to know about a
unicorn.</li>
<li>A unicorn is a fabulous creature. Org-mode wants to be a fabulous
creation.</li>
</ul>
<p>
Using a unicorn was originally <i>Bastien Guerry’s</i> idea. His friend,
the french artist <a href="http://intemperies.over-blog.com/">Christophe Bataillon</a>, designed the logo for us, and
<i>Greg Newman</i> gave it a refresh some time later. Bastien writes why
he chose a unicorn:
</p>
<blockquote>
<p>
The first reason is not linked to the animal, but to the sounding of the
word “Unicorn” - because Org gives you a /uni/que way of producing files
in several format (HTML, LaTeX, etc.).
</p>
<p>
The second reason is that a Unicorn doesn’t really exist, it is just
something you can dream about, and make others believe it does exist.
Just like the perfect organizer.
</p>
</blockquote>
<p>
There was a <a href="https://orgmode.org/list/[email protected]">thread about unicorns</a> on the mailing list. <a href="https://orgmode.org/list/[email protected]">Christopher
Suckling</a> posted a link showing how to make a simple foldable unicorn
(very appropriate for an outlining program!).
</p>
<p>
<a href="https://orgmode.org/list/[email protected]">Tim Burt</a> made a very complicated one which is now a treasured
possession of the Org-mode author.
</p>
<ul class="org-ul">
<li>Official logo: <img src="https://orgmode.org/img/org-mode-unicorn.png" alt="org-mode-unicorn.png" />
This logo is available in a number of different formats including
Photoshop <i>.psd</i> and scaleable vector graphics <i>.svg</i> <a href="https://orgmode.org/img/">here</a>.</li>
<li>An <a href="https://orgmode.org/img/nrocinu4.jpg">alternative version</a> from Christophe Bataillon (c):</li>
<li><a href="https://orgmode.org/list/B7CC380355F946DF8DCA0392A362CDB6@CUBE">Chris Randle</a> made a <a href="https://orgmode.org/img/nrocinu.txt">text version</a> using the logo and <a href="http://glassgiant.com">glassgiant.com</a>:</li>
<li><a href="https://orgmode.org/list/[email protected]">Stefan Vollmar</a> made a <a href="https://orgmode.org/img/nrocinu.pdf">pdf version</a> (here in <a href="https://orgmode.org/img/nrocinu_pdf.png">png</a>) using “a simple
threshold technique”.</li>
<li><a href="https://orgmode.org/list/[email protected]">Tim Burt</a> made a folded Unicorn to match the spirit of Org - see the
whole set of pictures <a href="http://www.flickr.com/photos/tcburt/sets/72157614543357071/">on his flickr page</a>.</li>
<li>Are unicorns real? Answer <a href="https://orgmode.org/list/[email protected]">here</a> by Ross Laird.</li>
</ul>
</div>
</div>
<div id="outline-container-orgee94c8d" class="outline-3">
<h3 id="orgee94c8d">Is Org’s documentation written in Org?</h3>
<div class="outline-text-3" id="text-orgee94c8d">
<p>
As of January 2018, yes. You can access the <code>.org</code> source of the manual
<a href="https://code.orgmode.org/bzg/org-mode/raw/master/doc/org-manual.org">on the repository</a>.
</p>
<p>
Previously, Org mode documentation was written in TeXinfo, which is the
standard format for Emacs documentation. Today, the Org mode documentation is exported to TeXinfo with the ox-texinfo exporter written by Jonathan Leech-Pepin and Nicolas Goaziou.
</p>
</div>
</div>
<div id="outline-container-orgfb4ca8c" class="outline-3">
<h3 id="orgfb4ca8c">Is there a bibtex entry for the Org manual?</h3>
<div class="outline-text-3" id="text-orgfb4ca8c">
<p>
Yes. Please evaluate this function and run <code>M-x
org-insert-manual-bibtex-citation-at-point RET</code>.
</p>
<div class="org-src-container">
<pre class="src src-emacs-lisp"><span style="color: #eb4509;">(</span><span style="color: #eb4509;">defun</span> <span style="color: #b6e63e;">org-insert-manual-bibtex-citation-at-point</span> <span style="color: #fd971f;">()</span>
<span style="color: #7f7f80;">"Insert a BibTeX citation of the Org manual at point."</span>
<span style="color: #fd971f;">(</span><span style="color: #eb4509;">interactive</span><span style="color: #fd971f;">)</span>
<span style="color: #fd971f;">(</span><span style="color: #fd971f;">insert</span>
<span style="color: #e2c770;">"@book{dominik10:_org_mode_refer_manual,</span>
<span style="color: #e2c770;"> author = {Carsten Dominik},</span>
<span style="color: #e2c770;"> title = {The Org-Mode 7 Reference Manual: Organize</span>
<span style="color: #e2c770;"> Your Life with GNU Emacs},</span>
<span style="color: #e2c770;"> publisher = {Network Theory},</span>
<span style="color: #e2c770;"> year = 2010,</span>
<span style="color: #e2c770;"> address = {UK},</span>
<span style="color: #e2c770;"> note = {with contributions by David O'Toole, Bastien Guerry,</span>
<span style="color: #e2c770;"> Philip Rooke, Dan Davison, Eric Schulte, and Thomas</span>
<span style="color: #e2c770;"> Dye}</span>
<span style="color: #e2c770;">}"</span>
<span style="color: #b6e63e;">(</span><span style="color: #fd971f;">message</span> <span style="color: #e2c770;">"Thanks for quoting the Org manual!"</span><span style="color: #b6e63e;">)</span><span style="color: #fd971f;">)</span><span style="color: #eb4509;">)</span>
</pre>
</div>
<p>
Please check <a href="org-papers.html">the Org papers page</a> for more references related to Org.
</p>
</div>
</div>
</div>
<div id="outline-container-orgb5fb61f" class="outline-2">
<h2 id="orgb5fb61f">Mailing list</h2>
<div class="outline-text-2" id="text-orgb5fb61f">
</div>
<div id="outline-container-bug-reporting" class="outline-3">
<h3 id="bug-reporting">I think my Org-mode is broken! How do I report a bug?</h3>
<div class="outline-text-3" id="text-bug-reporting">
<ol class="org-ol">
<li>Make sure you are running <a href="#updating-org">the latest version of Org-mode</a>.</li>
<li>Read <a href="https://orgmode.org/manual/Feedback.html">the Feedback section</a> of the manual.</li>
<li>Provide a minimal example that duplicates the bug.
<ul class="org-ul">
<li>Create a minimal .emacs file and start emacs with that file as
detailed in <a href="#minimal-emacs">these instructions</a>.</li>
<li>Create a sample, minimal .org file that reliably reproduces the
problem and post it to the mailing list.</li>
<li>Some users call this an “<a href="#ecm">ECM</a>”, a French acronym that means a
“minimal complete example”.</li>
</ul></li>
</ol>
</div>
</div>
<div id="outline-container-ecm" class="outline-3">
<h3 id="ecm">What is an “ECM”?</h3>
<div class="outline-text-3" id="text-ecm">
<p>
This is a French acronym used by some mailing list members; it
stands for “Exemple Complet Minimal”, or “Complete Minimal
Example”. The term refers to test files that can reliably reproduce
a bug with the minimal amount of code. When you report a bug to the
mailing list, you should provide a minimal .org file (with no more
text than necessary) that demonstrates the bug. See <a href="https://orgmode.org/list/[email protected]">this post</a> for
more information.
</p>
</div>
</div>
<div id="outline-container-when-to-contact-mailing-list" class="outline-3">
<h3 id="when-to-contact-mailing-list">What should I do before contacting the mailing list?</h3>
<div class="outline-text-3" id="text-when-to-contact-mailing-list">
<p>
The Org-mode mailing list is a high volume list, in which community
members discuss use cases, configuration, bugs, and developments.
</p>
<p>
If you are new to Org-mode, please read/search the excellent <a href="https://orgmode.org/manual/index.html">manual</a>
(and pay special attention to the indexes) before asking your
question.
</p>
<p>
You should also search the mailing list at <a href="http://lists.gnu.org/archive/html/emacs-orgmode/">lists.gnu.org</a> or
<a href="https://orgmode.org/list/">orgmode.org/list</a> to see if your issue has already been discussed.
</p>
<p>
See <a href="#can-org-do-x">this faq</a> for more details.
</p>
</div>
</div>
<div id="outline-container-ml-post-delay" class="outline-3">
<h3 id="ml-post-delay">Why hasn’t my email to the mailing list shown up yet?</h3>
<div class="outline-text-3" id="text-ml-post-delay">
<p>
The org-mode mailing list is moderated. Thus, if you are not
subscribed to the mailing list, your mail will only appear on the
list after it has been approved by a moderator. To ensure that your
mail appears quickly, please <a href="http://lists.gnu.org/mailman/listinfo/emacs-orgmode">subscribe to the list</a>.
</p>
</div>
</div>
<div id="outline-container-ml-subscription-and-gmane" class="outline-3">
<h3 id="ml-subscription-and-gmane">I read the mailing list through gmane. Should I subscribe?</h3>
<div class="outline-text-3" id="text-ml-subscription-and-gmane">
<p>
The org-mode mailing list is available via nntp at
<code>news.gmane.io/gmane.emacs.orgmode</code>. Many participants in the list
prefer to read the list in a newsreader, such as Gnus, instead of
receiving emails. If you choose to read the list via nntp, you can
still <a href="http://lists.gnu.org/mailman/listinfo/emacs-orgmode">subscribe</a> to the list and then opt not to receive any emails
on the mailman settings page (see the “Mail Delivery” setting).
</p>
<p>
This will ensure that your messages to the list get through
quickly, reduce the work load of the mailing list moderators (who
need to clear every mail from non-members), and provide more
accurate information about the number of list readers.
</p>
</div>
</div>
</div>
<div id="outline-container-Keeping-current" class="outline-2">
<h2 id="Keeping-current">Keeping current</h2>
<div class="outline-text-2" id="text-Keeping-current">
</div>
<div id="outline-container-new-exporter-switch" class="outline-3">
<h3 id="new-exporter-switch">Upgrading to Org 8.0/master and using the new export engine</h3>
<div class="outline-text-3" id="text-new-exporter-switch">
<p>
See <a href="org-8.0.html">Upgrading to Org 8.0 (or the current master branch)</a>.
</p>
</div>
</div>
<div id="outline-container-updating-org" class="outline-3">
<h3 id="updating-org">My Emacs ships with an older version Org-mode! How do I upgrade?</h3>
<div class="outline-text-3" id="text-updating-org">
<p>
Org-mode develops quickly, which means that versions of Org-mode
shipped with Emacs are more or less out-of-date. If you’d like to
upgrade to the most recent version of org-mode, you have a number of
options.
</p>
<ol class="org-ol">
<li>Download the <a href="https://orgmode.org/index.html#sec-3">most recent release</a> of org-mode as zip or tarball and
follow the <a href="https://orgmode.org/manual/Installation.html#Installation">installation instructions</a> in the manual.</li>
<li>Clone and install the development git repository as <a href="#keeping-current-with-Org-mode-development">explained
here</a>. If you don’t want to run the bleeding edge, you can still
use git <a href="#using-stable-releases-only">to track the most recent stable releases</a>.</li>
<li>Install and updated org-mode automatically through the Emacs
Package Manager as <a href="#installing-via-elpa">explained in this FAQ</a>.</li>
</ol>
<p>
<i>Note</i>: Please also see <a href="#mixed-install">Is my Orgmode installation mixed?</a> for a common
issue with mixed installations.
</p>
</div>
</div>
<div id="outline-container-keeping-current-with-Org-mode-development" class="outline-3">
<h3 id="keeping-current-with-Org-mode-development">How do I keep current with bleeding edge development?</h3>
<div class="outline-text-3" id="text-keeping-current-with-Org-mode-development">
<p>
Org-mode is developed in <a href="https://en.wikipedia.org/wiki/Git_(software)">Git</a>. You can keep up-to-date with Org-mode
developement by cloning the Org-mode repository and refreshing your
copy with latest changes whenever you wish. You only need to use
two Git commands (clone and pull.) Here are the steps in brief
(assuming a POSIX compatible shell and please customize locations
to suit your setup):
</p>
<ol class="org-ol">
<li><p>
Select a location to house the Org-mode repository (approx. 40
MB; includes documentation, compiled elisp files and history
going all the way back to v4.12a)
</p>
<pre class="example">
$ mkdir $HOME/elisp && cd $HOME/elisp
</pre></li>
<li><p>
Clone the Org-mode Git repository.
</p>
<p>
Recommended approach:
</p>
<pre class="example">
$ git clone [email protected]:bzg/org-mode.git
</pre>
<p>
(See <a href="worg-about.html#contribute-to-worg">The first time you contribute to Worg</a> for how to gain access).
</p></li>
<li><p>
Compile and install Org-mode and build documentation.
</p>
<pre class="example">
$ cd $HOME/elisp/org-mode && make
</pre>
<p>
Please note that you can choose to <i>not</i> compile at all and run
using source <code>.el</code> files only (compiled files speed things up),
but you will still need to generate the autoload files.
</p>
<pre class="example">
$ cd $HOME/elisp/org-mode && make uncompiled
</pre>
<p>
If you’d like to install org-mode someplace outside the source
tree (private or system-wide), you should edit <code>local.mk</code> to
point to the appropriate install location. You may need
administrator rights to do a system-wide installation.
</p>
<pre class="example">
$ cd $HOME/elisp/org-mode && make install
</pre></li>
<li>This is where you configure Org-mode with Emacs. Please refer
to <a href="./org-tutorials/index.html">Org tutorials</a>.</li>
<li><p>
Keeping up-to-date.
</p>
<p>
Cloning the repository is a one time activity. From this point
onwards you only need to <i>pull</i> the latest changes, which the
Makefile is set up to do automatically for certain make targets.
</p>
<pre class="example">
$ cd $HOME/elisp/org-mode && make update
</pre>
<p>
or if you immediately want to install as well
</p>
<pre class="example">
$ cd $HOME/elisp/org-mode && make update2
</pre>
<p>
Actually in this case it is recommended to run the test suite
before installation so that you don’t install a version that
fails testing.
</p>
<pre class="example">
$ cd $HOME/elisp/org-mode && make up2
</pre></li>
<li>You should reload Org-mode to have the changes take effect (if
you are not restarting Emacs, which is recommended). Also since
the intention is to “keep up” with Org-mode, you should visit
updated sections of documentation for latest updates (use <code>git
log</code>.)</li>
<li><p>
As you use your repository over time it will accumulate loose objects.
You can reduce the total size of your git repository with
</p>
<pre class="example">
$ git gc
</pre>
<p>
which will consolidate loose git objects into pack files. This
reduces the size of the repository and speeds up data access to
the objects.
</p></li>
</ol>
</div>
</div>
<div id="outline-container-update-info-manual-to-latest" class="outline-3">
<h3 id="update-info-manual-to-latest">How do I update the info manual pages to the latest org-mode version?</h3>
<div class="outline-text-3" id="text-update-info-manual-to-latest">
<p>
<b>This is not a problem if org-mode is installed system-wide, which
automatically takes care of this issue!</b> Since org-mode already
ships with Emacs, a rather common problem among users is “How do I
update the info documentation to the latest version of org-mode?”.
There are three ways to achieve this if for whatever reason you
can’t install into the standard, system-wide info directory:
</p>
<ol class="org-ol">
<li><p>
You can set the <code>INFOPATH</code> environment variable in your login
script like this:
</p>
<div class="org-src-container">
<pre class="src src-shell-script"> <span style="color: #696969;"># </span><span style="color: #696969;">~/.bash_profile</span>
<span style="color: #fd971f;">export</span> <span style="color: #fd971f;">INFOPATH</span>=/path/to/org-mode/info:$<span style="color: #fd971f;">INFOPATH</span>
...
</pre>
</div>
<p>
<code>/path/to/org-mode/info</code> is wherever you install org-mode.
</p></li>
<li><p>
You can achieve the same with elisp like this:
</p>
<div class="org-src-container">
<pre class="src src-emacs-lisp"> <span style="color: #696969;">;; </span><span style="color: #696969;">Info directory</span>
<span style="color: #eb4509;">(</span><span style="color: #b6e63e;">add-to-list</span> <span style="color: #9c91e4;">'</span><span style="color: #fd971f;">Info-additional-directory-list</span>
<span style="color: #fd971f;">(</span><span style="color: #fd971f;">expand-file-name</span> <span style="color: #e2c770;">"/path/to/org-mode/info"</span><span style="color: #fd971f;">)</span><span style="color: #eb4509;">)</span>
</pre>
</div></li>
<li><p>
You should specify the same location in the Makefile while
installing org-mode like this:
</p>
<div class="org-src-container">
<pre class="src src-makefile-gmake"> <span style="color: #696969;"># </span><span style="color: #696969;">Where local software is found</span>
<span style="color: #fd971f;">prefix</span>=/path/to/emacs-root
...
<span style="color: #696969;"># </span><span style="color: #696969;">Where info files go.</span>
<span style="color: #fd971f;">infodir</span> = $(<span style="color: #fd971f;">prefix</span>)/share/info
</pre>
</div></li>
</ol>
</div>
</div>
<div id="outline-container-keeping-local-changes-current-with-Org-mode-development" class="outline-3">
<h3 id="keeping-local-changes-current-with-Org-mode-development">How can I keep local changes and still track Org-mode development?</h3>
<div class="outline-text-3" id="text-keeping-local-changes-current-with-Org-mode-development">
<p>
There is no need to do this anymore for the purpose of adapting the
build system to the local environment, since this can now be
specified in <code>local.mk</code>. However, there may be a need to make other
local changes to Org.
</p>
<p>
Say you want to make minor changes to the <code>org.el</code> or any other
version controlled file from Org and you want to keep these changes
on top of the <code>master</code> branch from Org. Create a local branch for
your changes on top of origin/master as follows:
</p>
<pre class="example">
$ git checkout -b local origin/master
$ git config branch.local.rebase true
# Make your changes to the sources and create a new commit
$ git commit -am 'My local changes to Org'
# Update to a newer version
$ git pull
</pre>
<p>
Now each time you pull new commits from the distribution repository
your local commits will be rewound and replayed on top of the new
origin/master. You would normally work on your <code>local</code> branch which
includes your custom commits; there’s no need to switch back to the
<code>master</code> branch.
</p>
<p>
If you get a conflict during a <code>git pull</code> (a change in Org and one
of your local changes try to alter the same line of code) you will
need to edit the file with the conflict to fix up the conflicting
lines and then tell git that you have resolved the conflict:
</p>
<ol class="org-ol">
<li><code>git pull</code> fails with a conflict</li>
<li>edit the file: look for the conflict markers <code>>>>>>>></code> and
<code><<<<<<<</code> and either keep one version or create a new one and
remove all conflict markers while doing this.</li>
<li><code>git add</code> the file to the index to mark the conflict resolved</li>
<li><code>git rebase --continue</code></li>
<li>lather, rinse, and repeat 2-4 as needed</li>
</ol>
<p>
Note that it is possible to have silent conflicts when a change in
Org and one of your local changes do not edit the same line of code,
but are logically incompatible — for example Org might have changed
to assume <i>roses are red</i> while you’ve made a local change that
defines <i>my roses are yellow</i> in some other place. Git will not
warn you about such conflicts (it doesn’t understand what the code