Tidy: Headers, commentaries, etc.

This commit is contained in:
Adam Porter 2019-07-16 18:46:19 -05:00
parent 42138e2673
commit 9648dd12f9
2 changed files with 32 additions and 21 deletions

View file

@ -2,32 +2,27 @@
;; Author: Adam Porter <adam@alphapapa.net> ;; Author: Adam Porter <adam@alphapapa.net>
;; Url: http://github.com/alphapapa/org-ql ;; Url: http://github.com/alphapapa/org-ql
;; Version: 0.1-pre
;; Package-Requires: ((emacs "25.1") (dash "2.13") (org "9.0"))
;; Keywords: hypermedia, outlines, Org, agenda
;;; Commentary: ;;; Commentary:
;; This library displays buffers similar to Org Agenda buffers, based ;; This library is part of the package `org-ql'; it's not a standalone
;; library. It displays buffers similar to Org Agenda buffers, based
;; on `org-ql' queries. ;; on `org-ql' queries.
;;;; Principles ;;; License:
;;;;; Try to imitate traditional Org agenda code's results and methods ;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
;; The traditional agenda code is complicated, but well-optimized. We should imitate it where ;; This program is distributed in the hope that it will be useful,
;; possible. We should also attempt to return the same results as the traditional agenda code ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; (ultimately, that is; but whether we reach that level of complexity depends on, e.g. performance ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; achieved, whether it looks like a feasible alternative, etc). At the least, we should return ;; GNU General Public License for more details.
;; results in the same format, so they can be used by other code that uses agenda output
;; (e.g. org-agenda-finalize-entries, org-agenda-finalize, org-super-agenda, etc). Of course, this
;; goal does not necessarily apply to the "query language"-like features, and ideally the
;; agenda-like features should build upon those.
;;;;; Preserve the call to =org-agenda-finalize-entries= ;; You should have received a copy of the GNU General Public License
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;; We want to preserve the final call to org-agenda-finalize-entries to preserve compatibility
;; with other packages and functions.
;;; Code: ;;; Code:

View file

@ -9,9 +9,25 @@
;;; Commentary: ;;; Commentary:
;; `org-ql' is a lispy query language for Org files. It allows you to ;; `org-ql' is a lispy query language for Org files. It allows you to
;; find Org entries matching certain criteria and perform actions on ;; find Org entries matching certain criteria and return a list of
;; them, such as collecting their parsed representation with ;; them or perform actions on them. Commands are also provided which
;; `org-element' (the default action). ;; display a buffer with matching results, similar to an Org Agenda
;; buffer.
;;; License:
;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;;; Code: ;;; Code: