Browse Source

org-manual: Add missing markup

* doc/org-manual.org (The clock table): Add missing "=" markup for
  parts of an Org buffer.  Add "@noindent" directives.
Nicolas Goaziou 7 năm trước cách đây
mục cha
commit
5f78791b80
1 tập tin đã thay đổi với 31 bổ sung28 xóa
  1. 31 28
      doc/org-manual.org

+ 31 - 28
doc/org-manual.org

@@ -6581,12 +6581,12 @@ these options can be configured in the variable
 First there are options that determine which clock entries are to
 be selected:
 
-- :maxlevel ::
+- =:maxlevel= ::
 
      Maximum level depth to which times are listed in the table.
      Clocks at deeper levels are summed into the upper level.
 
-- :scope ::
+- =:scope= ::
 
      The scope to consider.  This can be any of the following:
 
@@ -6601,7 +6601,7 @@ be selected:
      | ~file-with-archives~   | current file and its archives                            |
      | ~agenda-with-archives~ | all agenda files, including archives                     |
 
-- :block ::
+- =:block= ::
 
      The time block to consider.  This block is specified either
      absolutely, or relative to the current time and may be any of
@@ -6626,40 +6626,40 @@ be selected:
      Use {{{kbd(S-LEFT)}}} or {{{kbd(S-RIGHT)}}} to shift the time
      interval.
 
-- :tstart ::
+- =:tstart= ::
 
      A time string specifying when to start considering times.
      Relative times like ="<-2w>"= can also be used.  See [[*Matching
      tags and properties]] for relative time syntax.
 
-- :tend  ::
+- =:tend= ::
 
      A time string specifying when to stop considering times.
      Relative times like ="<now>"= can also be used.  See [[*Matching
      tags and properties]] for relative time syntax.
 
-- wstart ::
+- =:wstart= ::
 
      The starting day of the week.  The default is 1 for Monday.
 
-- mstart ::
+- =:mstart= ::
 
      The starting day of the month.  The default is 1 for the first.
 
-- :step ::
+- =:step= ::
 
      Set to ~week~ or ~day~ to split the table into chunks.  To use
      this, ~:block~ or ~:tstart~, ~:tend~ are needed.
 
-- :stepskip0 ::
+- =:stepskip0= ::
 
      Do not show steps that have zero time.
 
-- :fileskip0 ::
+- =:fileskip0= ::
 
      Do not show table sections from files which did not contribute.
 
-- :match ::
+- =:match= ::
 
      A tags match to select entries that should contribute.  See
      [[*Matching tags and properties]] for the match syntax.
@@ -6670,75 +6670,75 @@ There options are interpreted by the function
 ~org-clocktable-write-default~, but you can specify your own function
 using the =:formatter= parameter.
 
-- :emphasize ::
+- =:emphasize= ::
 
      When ~t~, emphasize level one and level two items.
 
-- :lang ::
+- =:lang= ::
 
      Language[fn:77] to use for descriptive cells like "Task".
 
-- :link ::
+- =:link= ::
 
      Link the item headlines in the table to their origins.
 
-- :narrow ::
+- =:narrow= ::
 
      An integer to limit the width of the headline column in the Org
      table.  If you write it like =50!=, then the headline is also
      shortened in export.
 
-- :indent ::
+- =:indent= ::
 
      Indent each headline field according to its level.
 
-- :tcolumns ::
+- =:tcolumns= ::
 
      Number of columns to be used for times.  If this is smaller than
      =:maxlevel=, lower levels are lumped into one column.
 
-- :level ::
+- =:level= ::
 
      Should a level number column be included?
 
-- :sort ::
+- =:sort= ::
 
      A cons cell containing the column to sort and a sorting type.
      E.g., =:sort (1 . ?a)= sorts the first column alphabetically.
 
-- :compact ::
+- =:compact= ::
 
      Abbreviation for =:level nil :indent t :narrow 40! :tcolumns 1=.
      All are overwritten except if there is an explicit =:narrow=.
 
-- :timestamp ::
+- =:timestamp= ::
 
      A timestamp for the entry, when available.  Look for SCHEDULED,
      DEADLINE, TIMESTAMP and TIMESTAMP_IA special properties (see
      [[*Special Properties]]), in this order.
 
-- :tags ::
+- =:tags= ::
 
      When this flag is non-~nil~, show the headline's tags.
 
-- :properties ::
+- =:properties= ::
 
      List of properties shown in the table.  Each property gets its
      own column.
 
-- :inherit-props ::
+- =:inherit-props= ::
 
      When this flag is non-~nil~, the values for =:properties= are
      inherited.
 
-- :formula ::
+- =:formula= ::
 
      Content of a =TBLFM= keyword to be added and evaluated.  As
      a special case, =:formula %= adds a column with % time.  If you
      do not specify a formula here, any existing formula below the
      clock table survives updates and is evaluated.
 
-- :formatter ::
+- =:formatter= ::
 
      A function to format clock data and insert it into the buffer.
 
@@ -6759,6 +6759,7 @@ To use a specific time range you could write[fn:78]
 ,#+END: clocktable
 #+end_example
 
+#+texinfo: @noindent
 A range starting a week ago and ending right now could be written as
 
 #+begin_example
@@ -6766,15 +6767,17 @@ A range starting a week ago and ending right now could be written as
 ,#+END: clocktable
 #+end_example
 
-A summary of the current subtree with % times would be:
+#+texinfo: @noindent
+A summary of the current subtree with % times would be
 
 #+begin_example
 ,#+BEGIN: clocktable :scope subtree :link t :formula %
 ,#+END: clocktable
 #+end_example
 
+#+texinfo: @noindent
 A horizontally compact representation of everything clocked during
-last week would be:
+last week would be
 
 #+begin_example
 ,#+BEGIN: clocktable :scope agenda :block lastweek :compact t