From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id AComN66KrGJZWQAAbAwnHQ (envelope-from ) for ; Fri, 17 Jun 2022 16:07:43 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id cJ9GNq6KrGJdnwAAG6o9tA (envelope-from ) for ; Fri, 17 Jun 2022 16:07:42 +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 8EEAE1FCE6 for ; Fri, 17 Jun 2022 16:07:42 +0200 (CEST) Received: from localhost ([::1]:37082 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o2CdR-0000Lc-CC for larch@yhetil.org; Fri, 17 Jun 2022 10:07:41 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53484) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o2Cbl-0007AE-M6 for emacs-orgmode@gnu.org; Fri, 17 Jun 2022 10:05:57 -0400 Received: from mail-pj1-x1030.google.com ([2607:f8b0:4864:20::1030]:50942) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o2Cbh-00085A-Rf for emacs-orgmode@gnu.org; Fri, 17 Jun 2022 10:05:57 -0400 Received: by mail-pj1-x1030.google.com with SMTP id e24so4057945pjt.0 for ; Fri, 17 Jun 2022 07:05:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=H1R1BJ1xGAE6DPJx1edE5diVI+368jcsWQ/k5lWHh1o=; b=n1cpnT5kBAgHug+kN9yg/Rf3CLyvc5AHh6yuR/K8XAUIur1DpNOpHVLeYmoDb5pj3q SrHYTcCpR3YIU+M3DY4eOtk/SkJ1uBYUzgrN1KGOW+F9KbSuybMG5f5TbrcS0nj5bC1r GEJg3LKi8bnhumeSVRGy+kevS7meksahthMbdi+yJnmEtk6d09J35xoUhyb1HBqZNJuh 6vBGn/IVnesJhOsn++JLD1u++QBBEJHhPOxD4dgmaZ2AvlA/WzvSAIlqoHZ+AbKLoL4v 705FdlVMKNaCCRuRs6m+T4hnyW6nT57/YDWfYMh7jxTxAS8vFzSGVICXb4K10VselxNw 5bKg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=H1R1BJ1xGAE6DPJx1edE5diVI+368jcsWQ/k5lWHh1o=; b=UfLA7xABzZdgn2djzMSBzaWV+Ls+D+asL0B2hnhzesjjLOWmD8mhVuuSdPqeEvy83U I6Ps94e28O2g0JyIbF/3xSPKoEvdoWG3uDhIgmjVNgZnBKg4JnqOok44m732DQbc/HGd 9MU8e/qOSJ3jLHiSIti+1UHMm9RUz0wOp2tCrIOn2MbMygH2u8Ybv+yB54tBE4zUy7EY +PoB/km4YyKvBRd3uU5DTXWlhKHOwB5lRO0Qsp/TTcpBxTOzALg4rMsc3N3HLBdLUmA+ yrWhjkeH3Hb/sfUD7j6heqgRE2+mCad684XHdGheVZ4pn4NICAsKoux5x0JR5EF7gFNI FjIw== X-Gm-Message-State: AJIora8b0j9KBeip/13ONXPiwq00t+YNow9kc+gBENBbjSAnPa8ooam/ iEdNRWrZjj/ckDxxBPj1iCp0PSTQzqiwpe9jyYI= X-Google-Smtp-Source: AGRyM1sEhP6oCkd/isGlZgMD/B4hRkgFiK6UKiiFPseOO/1CdfDfFIQ3bpg/a5gpPVlsZKR2xb8CT8aM4hEJKytLjuM= X-Received: by 2002:a17:90b:3b88:b0:1e6:7aa2:4301 with SMTP id pc8-20020a17090b3b8800b001e67aa24301mr21498659pjb.118.1655474751563; Fri, 17 Jun 2022 07:05:51 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Kaushal Modi Date: Fri, 17 Jun 2022 10:05:14 -0400 Message-ID: Subject: Re: Utility of description lists To: Cletip Cletip Cc: Org Mode List Content-Type: text/plain; charset="UTF-8" Received-SPF: pass client-ip=2607:f8b0:4864:20::1030; envelope-from=kaushal.modi@gmail.com; helo=mail-pj1-x1030.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1655474862; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=H1R1BJ1xGAE6DPJx1edE5diVI+368jcsWQ/k5lWHh1o=; b=KxQyIV1jLPDQMtCC9ITrxUrscM5XOigq27iPMXY6phw6yd481DZKGeEQYSlXwNLsLPwiTD ZllUb1GhXEkNMGv//93LvAhOt8XvLjZvPsd8RJ5yyqigHl7r6zt/nduGrvfY8/hV9YE0Va ZxZkCy6N9IJC3S7zk2NxA9BuET5JxsMd6EdEoQYLSlLk/XTDUTwaCu86mhoWjYYEf7P7kC GZINJmxWeRMv8oLSFd4J3VW29XekA5/tOQEJ2AlMxt0DcRKK3rtbh9tt9nlyCp2/PzK92p gDvLOUHHP1NdXAc6/6EwsnxFWnQ7xSWQTLPWFqpA0GLoDzTixQBqqZN9X60how== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1655474862; a=rsa-sha256; cv=none; b=mjwa4b1Uu/7lh/5jYm+YIeQazl9bk2IifTZiEAh6BgMoZrGpwJ+t/01HBSjBWWeT3UFvis q4rgBzxVF845jJuSbrDgz4KwkQZS/yr5pKTA4uUEQAlSViC1UnUV0JNyN+lIpremZD6Hhw kXUPL0I/txCtPnEYHeJNT0cf7H9flDaZoPLc4Q24RJfEe2tB7+fPQohj4FJedvlpxXOH8a ckTABd61Z8aC3eNm69qC5LIbjaPgo45LdAZet/jD+/mqDU8ki6mQ0NgJ4RShwhPXdK3OeM CIjtR9HZXGJJsJINJVu9US2To8AfIW8+nc2XZQ14pc3oul5qZL5owsx0Zbl0nA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=n1cpnT5k; dmarc=pass (policy=none) header.from=gmail.com; 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-Spam-Score: -5.29 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=n1cpnT5k; dmarc=pass (policy=none) header.from=gmail.com; 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: 8EEAE1FCE6 X-Spam-Score: -5.29 X-Migadu-Scanner: scn0.migadu.com X-TUID: OT5AtyybVkBC On Fri, Jun 17, 2022 at 8:50 AM Cletip Cletip wrote: > Final question : why do you use description lists and not another ? I use description lists *heavily*. 1. For description lists of course.. where the "description" part is a bit verbose and plain lists don't look at that elegant For example, this in Org ===== ****** Customizing ~local.mk~ (Optional) Here are few variables that you might like to change in the ~local.mk~: - ~prefix~ :: Org installation directory #+begin_src makefile prefix = /dir/where/you/want/to/install/org # Default: /usr/share #+end_src The ~.el~ files will go to ~$(prefix)/emacs/site-lisp/org~ by default. If you'd like to change that, change the ~lispdir~ variable too. - ~infodir~ :: Org Info installation directory. I like to keep the Info file for development version of Org in a separate directory. #+begin_src makefile infodir = $(prefix)/org/info # Default: $(prefix)/info #+end_src - ~ORG_MAKE_DOC~ :: Types of Org documentation you'd like to build by default. Setting below generates only the Org Info manual. #+begin_src makefile ORG_MAKE_DOC = info # Default: html pdf #+end_src ===== exports to https://scripter.co/building-org-development-version/#customizing-local-dot-mk--optional 2. Where something would belong in a sub-heading, but not quite exactly? I can only describe that using one of my examples: ===== ***** Using ~pip install~ If you do not want to manually download the ~.jar~, there's a Python wrapper available to do the same for you: [[https://github.com/svenkreiss/html5validator][html5validator]]. - Install :: #+begin_src shell pip install --user html5validator #+end_src - Run :: #+begin_src shell html5validator --root public/ #+end_src It seems like this Python wrapper implicitly passes ~--skip-non-html ===== exports to https://scripter.co/offline-html5-validator/#using-pip-install 3. Sometimes I also use it for adding Notes to a section ===== - Note :: While the =%.1f= format is handy for those who are used to =printf()= syntax, note that Calc unlimited precision numbers are converted to double floats before applying =%.1f=. Whereas =f1= operates on Calc numbers without conversion. ===== exports to the Note in https://scripter.co/field-formatters-in-org-table/#using-calc-f1-formatter