소스 검색

org-duration: Improve docstring

* lisp/org-duration.el (org-duration-format): Clarify docstring.
Nicolas Goaziou 8 년 전
부모
커밋
b712c4f77a
1개의 변경된 파일11개의 추가작업 그리고 12개의 파일을 삭제
  1. 11 12
      lisp/org-duration.el

+ 11 - 12
lisp/org-duration.el

@@ -123,23 +123,22 @@ A non-nil REQUIRED? value for these keys indicates that the
 corresponding time component should always be included, even if
 corresponding time component should always be included, even if
 its value is 0.
 its value is 0.
 
 
-Eventually, the list can contain an entry indicating special
-formatting needs.  It can follow one of the three following
-patterns:
+Eventually, the list can contain one of the following special
+entries:
 
 
   (special . h:mm)
   (special . h:mm)
   (special . h:mm:ss)
   (special . h:mm:ss)
-  (special . PRECISION)
 
 
-When any of the first two is present, a duration is expressed in
-mixed mode, where the hours and minutes of the duration are
-expressed as a \"H:MM:SS\" or \"H:MM\" string while still using
-other units defined.
+    Units shorter than an hour are ignored.  The hours and
+    minutes part of the duration is expressed unconditionally
+    with H:MM, or H:MM:SS, pattern.
+
+  (special . PRECISION)
 
 
-With the last pattern, a duration is expressed with a single
-unit, PRECISION being the number of decimal places to show.  The
-unit chosen is the first one required or with a non-zero integer
-part.  If there is no such unit, the smallest one is used.
+    A duration is expressed with a single unit, PRECISION being
+    the number of decimal places to show.  The unit chosen is the
+    first one required or with a non-zero integer part.  If there
+    is no such unit, the smallest one is used.
 
 
 For example,
 For example,