From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id oNTtFdcReWR3KwEASxT56A (envelope-from ) for ; Thu, 01 Jun 2023 23:47:03 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id iGfrFdcReWTY+wAA9RJhRA (envelope-from ) for ; Thu, 01 Jun 2023 23:47:03 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id D4FFD2690B for ; Thu, 1 Jun 2023 23:47:02 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q4q7G-0008Vo-Qn; Thu, 01 Jun 2023 17:45:55 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q4q79-0008Se-VW for emacs-orgmode@gnu.org; Thu, 01 Jun 2023 17:45:51 -0400 Received: from mail-pf1-f182.google.com ([209.85.210.182]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1q4q76-0007HS-HP for emacs-orgmode@gnu.org; Thu, 01 Jun 2023 17:45:46 -0400 Received: by mail-pf1-f182.google.com with SMTP id d2e1a72fcca58-64d57cd373fso2040206b3a.1 for ; Thu, 01 Jun 2023 14:45:40 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1685655939; x=1688247939; h=mime-version:message-id:date:subject:to:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=iiafxnepd9AonbiSZSJ9Lgv8nLDLo3lEr2jenblTg/8=; b=Bfm+aLntE+SYQE8G5I6BQm4MJaOKABcfLA0zbslwvg/o4VeIZSuJRuf85hx971GFPO SWKMurgfkzoGGwuMbkZpkLPMhOgEZ2Xu1BDKK+oTVO4PgkUEzG+B+xppMLl+0mtc4feF aKyClZlS0J80VybzsvNWUIisaNY9dugZ/bPbgXKkHxo+quIGnlmLiGjJdefJwSeoPStt 7igvbiOACjNuV6KneVIASMmxd0OtZkQN8BA6G1Zhx1i9DcXNqvfzxsPUbf5WI09DHSSQ AmwYpCsYd9FKMUQPQdcs7NdFKNMrr44R+6UNdv/8pxloqYb2i94EpZjswhNufkWbqDNI Ev4g== X-Gm-Message-State: AC+VfDwV60UopOhEWMge/NjL1VZ4p/fWi8QSz2ECQRyEaSfEqljbehOO 3p66KNz972Q2c0japsbDyUcyyuyjPHl3bz8B+I4= X-Google-Smtp-Source: ACHHUZ4ge54vWtgHj9TbVruC2kOv7uUeL5RJgNLkkzlbYrgVjRambPQ27DaU0HjE9RImkQLTxu49wQ== X-Received: by 2002:a05:6a21:32a5:b0:10b:764b:a942 with SMTP id yt37-20020a056a2132a500b0010b764ba942mr3410102pzb.11.1685655939148; Thu, 01 Jun 2023 14:45:39 -0700 (PDT) Received: from localhost ([64.43.28.143]) by smtp.gmail.com with ESMTPSA id n10-20020a6546ca000000b0053f22b76cdcsm3338426pgr.82.2023.06.01.14.45.37 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 01 Jun 2023 14:45:38 -0700 (PDT) To: emacs-orgmode@gnu.org Subject: [PATCH] org-manual: Mark up nil as ~nil~ [9.6.6 (release_9.6.6 @ /home/blc/.local/share/emacs/30.0.50/lisp/org/)] Date: Thu, 01 Jun 2023 22:45:35 +0100 Message-ID: <87o7lyambk.fsf@tcd.ie> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=209.85.210.182; envelope-from=contovob@tcd.ie; helo=mail-pf1-f182.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-to: Basil L. Contovounesios From: Basil L. Contovounesios via "General discussions about Org-mode." Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1685656022; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post; bh=iiafxnepd9AonbiSZSJ9Lgv8nLDLo3lEr2jenblTg/8=; b=Am6gI2mLDQleWkT+Si5YBDTENnqcf3rkgPAQ28JIbSnBPRLm1fB6zU7nUKvSWAxcAUri6E zF6XoVFHEYvTbwnpbq8U2k+tOo172IyME9EQosPnIDCDLwxCwLlcERhCUe8V83z+tW+UuC H8wlE2+p0lw63kjwEqZi/93soJqmbpnR9PYV/jzed0fPDOJK19SKilmUbgle+KULu0Eyky app6U2R2wItHxNokM3iASJ+pa9rQ4zUJXbtMJ05JmaNWAHXuuSVaeWJ6qK10zlwcxp4ER8 GVDq8XuXrjGY+N+0H4Fhzyv+wzOTtV4JI3ozHkdIyFBpW9t/KZEk2570/JJjfA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1685656022; a=rsa-sha256; cv=none; b=luXIsSjwlxz4gpD0ByvUSoRUmtE9kM6MY4C2XLyNEq+B+7untHnaskcq5Srsldb8Pr4L8W zgI7f0cOP6Xg6CnCgp1G7CuvLnTwthMHKkqDRiwBOE/QnFTqjSsbmvd9p9RRvAkHqRXphq A1TD2w/brvGKU8bAvPZzzc2fET3uuW+TfsHLcgFgpgRX4Ky3yM2cjyQ76u5frCaW8VEkeH hS3O4QbkP4Pl/DFUMWwwTRfC/Ir6fwpFD2s3Rx7G9M1l967vsmPvNK0joGUhNUqIk5plpO zjQCsDCfyi/NK+MQqx8vxc73+qKzITcSg2eHfBh2VkymRfvloTr4nh+z8wNJiQ== X-Migadu-Scanner: scn1.migadu.com X-Migadu-Spam-Score: -3.47 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: D4FFD2690B X-Spam-Score: -3.47 X-TUID: DDPGgs5qil1c --=-=-= Content-Type: text/plain In emacs.git I noticed some occurrences of 'nil' in the generated doc/misc/org.texi were not marked up as @code. Is this TRT? (I already have an Emacs CA on file.) --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-doc-org-manual.org-Mark-up-nil-as-nil.patch >From 69ee9636fb2cd52efe8c11ca5877c83fb984a9ea Mon Sep 17 00:00:00 2001 From: "Basil L. Contovounesios" Date: Thu, 1 Jun 2023 22:19:28 +0100 Subject: [PATCH] doc/org-manual.org: Mark up nil as ~nil~ * doc/org-manual.org (Images, Plain lists in Texinfo export) (Results of Evaluation): Mark up plain nil as ~nil~. (Org Crypt): Ditto. Clarify wording. --- doc/org-manual.org | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index ab5c10c1d..537cd046f 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -11597,8 +11597,8 @@ command: =ORG-IMAGE-ACTUAL-WIDTH= property (subtree-level)[fn:: The width can be customized in Emacs >= 24.1, built with imagemagick support.]. Their value can be the following: - - (default) Non-nil, use the actual width of images when inlining them. - If the actual width is too wide, limit it according to + - (default) Non-~nil~, use the actual width of images when inlining + them. If the actual width is too wide, limit it according to ~org-image-max-width~. - When set to a number, use imagemagick (when available) to set the image's width to this value. @@ -11608,7 +11608,7 @@ command: ,#+ATTR_HTML: :width 300px #+end_example and fall back on that number if none is found. - - When set to nil, try to get the width from an =#+ATTR.*= keyword + - When set to ~nil~, try to get the width from an =#+ATTR.*= keyword and fall back on the original width or ~org-image-max-width~ if none is found. @@ -11618,8 +11618,8 @@ command: - (default) ~fill-column~, limit width to ~fill-column~ number of characters. - ~window~, limit width to current window width. - - integer number, limit width that specified number of pixels. - - nil, do not limit the width. + - integer number, limit width to that specified number of pixels. + - ~nil~, do not limit the width. #+vindex: org-cycle-inline-images-display Inline images can also be displayed when cycling the folding state. @@ -15756,9 +15756,9 @@ This is the common text for variables foo and bar. The =:compact= attribute is an alternative to the =:sep= attribute, which allows writing each entry on its own line. If this attribute is -non-nil and an item in a description list has no body but is followed -by another item, then the second item is transcoded to =@itemx=. This -example is transcoded to the same output as above. +non-~nil~ and an item in a description list has no body but is +followed by another item, then the second item is transcoded to +=@itemx=. This example is transcoded to the same output as above. #+begin_example ,#+ATTR_TEXINFO: :table-type vtable :indic asis :compact t @@ -18666,7 +18666,7 @@ options; they are mutually exclusive. but no processing is performed on the return value. Calling the code block programmatically (see [[*How to evaluate source code]]) or by reference (see [[*Passing arguments]] and [[*Noweb Reference Syntax]]) will - always yield nil. + always yield ~nil~. - =append= :: @@ -20932,8 +20932,8 @@ specifying the respective key as property =CRYPTKEY=, e.g.: :END: #+end_example -Note that =CRYPTKEY= property is only effective when ~org-crypt-key~ -is set to non-nil. ~nil~ value of ~org-crypt-key~ makes Org use +Note that the =CRYPTKEY= property is only effective when +~org-crypt-key~ is non-~nil~. If ~org-crypt-key~ is ~nil~, Org uses symmetric encryption unconditionally. Excluding the =crypt= tag from inheritance prevents already encrypted -- 2.34.1 --=-=-= Content-Type: text/plain This is one of my first times posting here, and I am not subscribed to the mailing list, so please keep me CCed and let me know if anything is amiss. Thanks, -- Basil Emacs : GNU Emacs 30.0.50 (build 1, x86_64-pc-linux-gnu, X toolkit, cairo version 1.16.0, Xaw3d scroll bars) of 2023-05-30 Package: Org mode version 9.6.6 (release_9.6.6 @ /home/blc/.local/share/emacs/30.0.50/lisp/org/) current state: ============== (setq org-archive-location "/home/blc/.emacs.d/org/archive.org::" org-list-use-circular-motion t org-checkbox-hierarchical-statistics nil org-link-elisp-confirm-function 'yes-or-no-p org-hierarchical-todo-statistics nil org-agenda-category-icon-alist '(("" (space :width (16)))) org-directory "/home/blc/.emacs.d/org/" org-global-properties '(("Effort_ALL" . "0 0:15 0:30 0:45 1:00 2:00 3:00")) org-agenda-scheduled-leaders '("" "%3dd -") org-log-done 'note org-log-into-drawer t org-agenda-timerange-leaders '("" "(%d/%d)") org-agenda-files "/home/blc/.emacs.d/org/agenda-index" org-persist-after-read-hook '(org-element--cache-persist-after-read) org-refile-targets '((org-agenda-files :maxlevel . 10)) org-export-before-parsing-hook '(org-attach-expand-links) org-cycle-tab-first-hook '(org-babel-hide-result-toggle-maybe org-babel-header-arg-expand) org-default-notes-file "/home/blc/.emacs.d/org/notes.org" org-refile-use-outline-path 'file org-archive-hook '(org-attach-archive-delete-maybe) org-log-reschedule 'note org-columns-default-format "%ITEM %TODO %LOCATION %TAGS" org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-show-empty-lines org-cycle-optimize-window-after-visibility-change org-cycle-display-inline-images) org-persist-before-read-hook '(org-element--cache-persist-before-read) org-agenda-sticky t org-modules nil org-mode-hook '(org-clock-load #[0 "\300\301\302\303\304$\207" [add-hook change-major-mode-hook org-fold-show-all append local] 5] #[0 "\300\301\302\303\304$\207" [add-hook change-major-mode-hook org-babel-show-result-all append local] 5] org-babel-result-hide-spec org-babel-hide-all-hashes #[0 "\301\211%10\207" [imenu-create-index-function org-imenu-get-tree] 2] turn-on-auto-fill bog-mode org-eldoc-load) org-babel-load-languages '((shell . t) (scheme . t) (python . t) (perl . t) (org . t) (ocaml . t) (makefile . t) (lisp . t) (ledger . t) (latex . t) (js . t) (java . t) (haskell . t) (C . t) (emacs-lisp . t)) org-ctrl-k-protect-subtree t org-agenda-todo-list-sublevels nil org-agenda-time-grid '((daily today require-timed) (800 1000 1200 1400 1600 1800 2000) "......" "----------------") org-agenda-tags-column -80 org-confirm-shell-link-function 'yes-or-no-p outline-isearch-open-invisible-function 'outline-isearch-open-invisible org-startup-indented t org-highlight-latex-and-related '(entities latex script) org-use-speed-commands t org-agenda-mode-hook '(hl-line-mode) org-list-demote-modify-bullet '(("+" . "-") ("-" . "+")) org-agenda-before-write-hook '(org-agenda-add-entry-text) org-log-redeadline 'note org-src-mode-hook '(org-src-babel-configure-edit-buffer org-src-mode-configure-edit-buffer) org-confirm-elisp-link-function 'yes-or-no-p org-agenda-todo-ignore-with-date t org-agenda-window-setup 'other-frame org-clock-idle-time 10 org-todo-keywords '((type "NEXT(n)" "TODO(t)" "PROJ(p)" "EXEC(e)" "MEET(m)" "WAIT(w)" "BALK(b)" "|" "DONE(d!)" "VOID(v@)") ) org-speed-command-hook '(org-speed-command-activate org-babel-speed-command-activate) org-clock-persist-file "/home/blc/.emacs.d/index/org-clock-save.el" org-fold-core-isearch-open-function 'org-fold-core--isearch-reveal org-capture-before-finalize-hook '(blc-org-prop-captured) org-M-RET-may-split-line nil org-clock-persist 'history org-persist-before-write-hook '(org-element--cache-persist-before-write) org-tab-first-hook '(org-babel-hide-result-toggle-maybe org-babel-header-arg-expand) org-link-shell-confirm-function 'yes-or-no-p org-babel-pre-tangle-hook '(save-buffer) org-agenda-loop-over-headlines-in-active-region nil outline-minor-mode-cycle t org-occur-hook '(org-first-headline-recenter) org-metadown-hook '(org-babel-pop-to-session-maybe) org-treat-S-cursor-todo-selection-as-state-change nil org-link-parameters '(("attachment" :follow org-attach-follow :complete org-attach-complete-link) ("id" :follow org-id-open) ("file+sys") ("file+emacs") ("shell" :follow org-link--open-shell) (#1="news" :follow #[514 #2="\301\300\302%4Q%2\"\207" [#1# browse-url #4=":"] 6 #5="\n\n(fn URL ARG)"]) (#3="mailto" :follow #[514 #2# [#3# browse-url #4#] 6 #5#]) (#6="https" :follow #[514 #2# [#6# browse-url #4#] 6 #5#]) (#7="http" :follow #[514 #2# [#7# browse-url #4#] 6 #5#]) (#8="ftp" :follow #[514 #2# [#8# browse-url #4#] 6 #5#]) ("help" :follow org-link--open-help :store org-link--store-help) ("file" :complete org-link-complete-file) ("elisp" :follow org-link--open-elisp)) org-metaup-hook '(org-babel-load-in-session-maybe) org-refile-allow-creating-parent-nodes 'confirm org-property-format "%-20s %s" org-outline-path-complete-in-steps nil org-special-ctrl-a/e t org-reverse-note-order t org-agenda-current-time-string "now - - - - - - - - - - - - - - - - - - - - - - - - -" org-agenda-block-separator 61 org-footnote-section nil org-list-allow-alphabetical t org-agenda-deadline-leaders '("" "%3dd +" "%3dd -") ) --=-=-=--