diff options
author | Nicolas Goaziou <mail@nicolasgoaziou.fr> | 2018-05-02 12:48:38 +0200 |
---|---|---|
committer | Nicolas Goaziou <mail@nicolasgoaziou.fr> | 2018-05-02 12:48:38 +0200 |
commit | 0b8aa5b3cb2d4d9645e4d44d6d24a4bd2d240758 (patch) | |
tree | cdd03752d7ecd843fec566c5bffa3eabb3f66bdd | |
parent | c64cdff0888a6dce08392865a2201a4a66506e72 (diff) | |
download | org-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.org | 10 |
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 |