emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Bug] Documentation error(s) for org-babel-tangle-default-file-mode


From: Aitenate
Subject: [Bug] Documentation error(s) for org-babel-tangle-default-file-mode
Date: Thu, 19 Dec 2024 19:21:36 +0000
User-agent: Mozilla Thunderbird

I think there a couple of issues with the documentation for org-babel-tangle-default-file-mode. It seemed easiest to describe using a patch:

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 0f6d6a067..7d703993f 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -19521,7 +19521,7 @@ unexpected results (=444= is the same as =o674=).
 Two other shorthands are recognized, ls-style strings like
 =rw-r--r--=, and chmod-style permissions like =g+w=.
 Note that chmod-style permissions are based on
-~org-babel-tangle-default-file-mode~, which is =#o544= by default.
+~org-babel-tangle-default-file-mode~, which is =#o644= by default.

 When =:tangle-mode= and =:shebang= are both specified, the give
 =:tangle-mode= will override the permissions from =:shebang=.  When
diff --git a/lisp/ob-tangle.el b/lisp/ob-tangle.el
index fe353ec9c..c35525162 100644
--- a/lisp/ob-tangle.el
+++ b/lisp/ob-tangle.el
@@ -159,9 +159,10 @@ result. The default value is `org-remove-indentation'."
   :type 'function)

 (defcustom org-babel-tangle-default-file-mode #o644
-  "The default mode used for tangled files, as an integer.
-The default value 420 correspands to the octal #o644, which is
-read-write permissions for the user, read-only for everyone else."
+  "The default mode, an integer value, only used when the :tangle-mode
+header argument specifies chmod-style symbolic notation.  The default
+value 420 corresponds to the octal #o644, which is read-write
+permissions for the user, read-only for everyone else."
   :group 'org-babel-tangle
   :package-version '(Org . "9.6")
   :type 'integer)

If I've misread something, apologies for the noise.

Regards,

Aitenate



reply via email to

[Prev in Thread] Current Thread [Next in Thread]