summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNicolas Goaziou <mail@nicolasgoaziou.fr>2018-05-02 12:48:38 +0200
committerNicolas Goaziou <mail@nicolasgoaziou.fr>2018-05-02 12:48:38 +0200
commit0b8aa5b3cb2d4d9645e4d44d6d24a4bd2d240758 (patch)
treecdd03752d7ecd843fec566c5bffa3eabb3f66bdd
parentc64cdff0888a6dce08392865a2201a4a66506e72 (diff)
downloadorg-mode-0b8aa5b3cb2d4d9645e4d44d6d24a4bd2d240758.tar.gz
org-manual: Document "tangle-mode" header argument
* doc/org-manual.org (Extracting Source Code): Document "tangle-mode" header argument.
-rw-r--r--doc/org-manual.org10
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/org-manual.org b/doc/org-manual.org
index 8c98859..d105b9e 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -17534,6 +17534,16 @@ files. By setting it to a string value---for example, =:shebang
tangled file that the code block is extracted to. Org then turns on
the tangled file's executable permission.
+#+cindex: @samp{tangle-mode}, header argument
+The =tangle-mode= header argument specifies what permissions to set
+for tangled files by ~set-file-modes~. For example, to make
+a read-only tangled file, use =:tangle-mode (identity #o444)=. To
+make it executable, use =:tangle-mode (identity #o755)=. It also
+overrides executable permission granted by =shebang=. When multiple
+source code blocks tangle to a single file with different and
+conflicting =tangle-mode= header arguments, Org's behavior is
+undefined.
+
#+cindex: @samp{no-expand}, header argument
By default Org expands code blocks during tangling. The =no-expand=
header argument turns off such expansions. Note that one side-effect