Mercurial > emacs
view man/msdog-xtra.texi @ 80467:1d830d9c60e0
* textmodes/org-export-latex.el: New file.
* textmodes/org-irc.el: New file.
* textmodes/org-mac-message.el: New file.
* textmodes/org-publish.el: New file.
* textmodes/org.el (org-agenda-collect-markers)
(org-create-marker-find-array)
(org-check-agenda-marker-table, org-extract-log-state-settings)
(org-nofm-to-completion, org-refile-goto-last-stored)
(org-export-html-convert-special-strings, org-first-list-item-p)
(org-imenu-new-marker, org-imenu-get-tree)
(org-speedbar-set-agenda-restriction)
(org-agenda-set-restriction-lock)
(org-agenda-remove-restriction-lock)
(org-agenda-maybe-redo, org-compute-latex-and-specials-regexp)
(org-do-latex-and-special-faces, org-read-date-display)
(org-select-remember-template, org-agenda-copy-local-variable)
(org-read-date-get-relative, org-columns-cleanup-item)
(org-find-entry-with-id)
(org-insert-columns-dblock, org-listtable-to-string)
(org-dblock-write:columnview, org-columns-capture-view)
(org-edit-headline, org-parse-local-options)
(org-in-clocktable-p, org-property-or-variable-value)
(org-get-tags-string, org-up-heading-safe)
(org-fast-todo-selection, org-get-wdays)
(org-switch-to-buffer-other-window, org-agenda-deadline-face)
(org-add-link-type, org-columns-content, org-columns-widen)
(org-columns-next-allowed-value, org-columns-edit-allowed)
(org-columns-store-format)
(org-columns-uncompile-format, org-columns-redo)
(org-columns-edit-attributes, org-delete-property)
(org-set-property, org-columns-update, org-columns-compute)
(org-columns-eval)
(org-columns-not-in-agenda, org-columns-compute-all)
(org-property-next-allowed-value)
(org-columns-compile-format, org-fill-paragraph-experimental)
(org-string-to-number, org-property-action, org-columns-move-left)
(org-columns-new)
(org-column-number-to-string, org-property-previous-allowed-value)
(org-at-property-p, org-columns-delete)
(org-columns-previous-allowed-value)
(org-columns-move-right, org-columns-narrow)
(org-property-get-allowed-values)
(org-verify-version, org-column-string-to-number)
(org-delete-property-globally)
(org-get-property-block, org-entry-properties, org-entry-get)
(org-entry-delete, org-entry-get-with-inheritance)
(org-entry-put, org-buffer-property-keys, org-new-column-overlay)
(org-overlay-columns)
(org-overlay-columns-title, org-remove-column-overlays)
(org-column-show-value, org-column-quit, org-column-edit)
(org-cached-entry-get, org-table-put-field-property)
(org-get-columns-autowidth-alist, turn-on-orgstruct)
(orgstruct-error, orgstruct-setup)
(orgstruct-make-binding, org-context-p, org-get-local-variables)
(org-run-like-in-org-mode)
(org-make-link-regexps, org-remove-keyword-keys)
(org-get-todo-face, org-export-get-title-from-subtree)
(org-assign-fast-keys, org-get-min-level)
(org-get-wdays, org-clock-find-position)
(org-clock-goto, org-fontify-priorities)
(org-get-date-from-calendar)
(org-entry-add-to-multivalued-property)
(org-entry-remove-from-multivalued-property)
(org-entry-member-in-multivalued-property)
(org-entry-is-todo-p, org-entry-is-done-p, org-get-todo-state)
(org-agenda-get-restriction-and-command)
(org-open-link-from-string, org-columns-open-link)
(org-go-to-remember-target, org-remember-insinuate)
(org-icalendar-cleanup-string, org-first-sibling-p)
(org-back-over-empty-lines, org-skip-whitespace)
(org-goto-local-auto-isearch)
(org-clocktable-steps, org-refile-get-location)
(org-kill-line, org-remove-timestamp-with-keyword)
(org-local-logging): New functions.
(org-agenda-marker-table, org-log-note-how)
(org-goto-local-auto-isearch-map)
(org-last-remember-storage-locations)
(org-imenu-markers, org-agenda-restriction-lock-overlay)
(org-speedbar-restriction-lock-overlay)
(org-massive-special-regexp)
(org-verbatim-re, org-read-date-display-live)
(org-agenda-file-regexp, org-complex-heading-regexp)
(org-completion-fallback-command, org-todo-log-states)
(org-goto-exit-command, org-goto-selected-point)
(org-todo-key-alist, org-todo-key-trigger, org-agenda-remove-date)
(org-agenda-after-show-hook, org-agenda-skip-unavailable-files)
(org-fast-tag-selection-can-set-todo-state, org-local-properties)
(org-store-link-functions, org-columns-top-level-marker)
(orgstruct-mode-map, org-entry-property-inherited-from)
(org-column-overlays, org-current-columns-fmt)
(org-current-columns-maxwidths, org-column-map)
(org-cached-props): New variables.
(org-special-ctrl-k, org-goto-auto-isearch)
(org-agenda-todo-keyword-format)
(org-remember-use-refile-when-interactive)
(org-imenu-depth, org-highlight-latex-fragments-and-specials)
(org-agenda-skip-scheduled-if-done, org-extend-today-until)
(org-agenda-window-frame-fractions, org-fontify-priorities)
(org-agenda-deadline-leaders, org-use-property-inheritance)
(org-clock-into-drawer, org-agenda-compact-blocks)
(org-use-fast-todo-selection, org-fast-tag-selection-include-todo)
(org-edit-timestamp-down-means-later, org-todo-keyword-faces)
(org-agenda-deadline-faces, org-remember-store-without-prompt)
(org-default-columns-format)
(org-agenda-default-appointment-duration)
(org-export-with-footnotes, org-clock-out-when-done)
(org-global-properties, org-todo-keyword-faces)
(org-archive-save-context-info)
(org-edit-timestamp-down-means-later)
(org-scheduled-past-days, org-export-with-drawers)
(org-read-date-prefer-future, org-hide-emphasis-markers)
(org-clock-heading-function, org-clock-in-switch-to-state)
(org-export-with-special-strings): New options.
(org-link-store, org-link-follow, org-latex)
(org-remember-templates, org-time-stamp-rounding-minutes)
(org-back-over-empty-lines, org-find-base-buffer-visiting)
(org-columns-new): Fix typos in docstrings.
(org-ctrl-c-star): Implement a missing branch in the decision
tree.
(org-select-remember-template): Clean the code.
(org-prepare-dblock): Add the extra :content parameter.
(org-write-agenda): New output type ".ics" files.
(org-write-agenda): Call `org-icalendar-verify-function', both for
time stamps and for TODO entries.
(org-export-as-html): Revert the change that killed the html
buffer. Side effects first need to be studied carefully.
(org-get-tags-at): Fix the structure of the condition-case
statement.
(org-ts-regexp0, org-repeat-re, org-display-custom-time)
(org-timestamp-change): Fix regulear expressions to swallow the
extra character for repeat-shift control.
(org-auto-repeat-maybe): Implement the new repeater mechanisms.
(org-get-legal-level): Alias to `org-get-valid-level'.
(org-dblock-write:clocktable): Add a :link parameter, linking
headlines to their location in the Org agenda files.
(org-get-tags-at): Bugfix: prevent `org-back-to-heading' from
throwing an error when getting tags before headlines.
(org-timestamp-change, org-modify-ts-extra)
(org-ts-regexp1): Fix timestamp editing.
(org-agenda-custom-commands-local-options): New constant.
(org-agenda-custom-commands): Use
`org-agenda-custom-commands-local-options' to improve customize
type. "htmlize": Removed hack to fix face problem with htmlize,
it no longer seem necessary.
(org-follow-link-hook): New hook.
(org-agenda-custom-commands): Add "Component" as a tag for each
item in a command serie.
(org-open-at-point): Run `org-follow-link-hook'.
(org-agenda-schedule): Bugfix: don't display marker type when it
is nil.
(org-store-link): org-irc required.
(org-set-regexps-and-options): Parse the new logging options.
(org-todo): Handle the new ways of recording state change stuff.
(org-columns-open-link): Fix bug with opening link in column view.
(org-todo): Make sure that LOGGING properties are honoured.
(org-todo-keywords): Improve docstring.
(org-startup-options): Cleanup startup options.
(org-set-regexps-and-options): Process the "!" markers.
(org-todo): Respect the new logging stuff.
(org-add-log-maybe): New parameter HOW that defines how logging
should be done and also overrides PURPOSE. Add a docstring.
(org-add-log-note): Check if we really need to ask for a note.
(org-get-current-options): Digest the new keyword.
(org-agenda-reset-markers): Rename from
`org-agenda-maybe-reset-markers'. Remove FORCE argument.
(org-diary, org-agenda-quit, org-prepare-agenda): Call the renamed
function, without force argument.
(org-buffer-property-keys): Bind local variables s and p.
(org-make-tags-matcher): Allow "" to match an empty or
non-existent property value.
(org-export-as-html): Join unsorted lists when they directly
follow each other. Such lists may be created by headlines that
are converted to lists.
(org-export-as-html): Use :html-extension instead of
org-export-html-extension.
(org-store-link): Support for links from `rmail-summary-mode'.
(org-columns-new, org-complete, org-set-property): Set the
`include-columns' argument in the call to
`org-buffer-property-keys'.
(org-buffer-property-keys): New argument `include-columns', to
include properties expected by any of the COLUMS formats in the
current buffer.
(org-cleaned-string-for-export): Get rid of drawers first, so that
they will be removed also in the text before the first headline.
(org-clock-report): Show the clocktable when found.
(org-refile): Fix positioning bug when `org-reverse-note-order' is
nil.
(org-version): With prefix argument, insert `org-version' at
point.
(org-agenda-goto): Recenter the window after finding the target
location, to make sure the correct position will be displayed.
(org-agenda-get-deadlines): Don't scale priority with the warning
period.
(org-insert-heading): Don't break line in the middle of the line.
(org-agenda-get-deadlines): Allow `org-deadline-warning-days' to
be 0.
(org-update-checkbox-count): Revamp to deal with hierarchical
beckboxes. This was a patch from Miguel A. Figueroa-Villanueva.
(org-schedule, org-deadline): Use
`org-remove-timestamp-with-keyword' to make sure all such time
stamps are removed.
(org-mode): Support for `align'.
(org-agenda-get-deadlines): Make sure priorities increase as the
due date approaches and is passed.
(org-remember-apply-template): Fix problem with tags that contain
"_" or "@".
(org-make-link-regexps): Improve the regular expression for plain
links.
(org-agenda-get-closed): List each clocking entry.
(org-set-tags): Only tabify before tags if indent-tabs-mode is t.
(org-archive-all-done): Fix incorrect number of stars in regexp.
(org-global-tags-completion-table): Add the value of org-tag-alist
in each buffer, to make sure that also unused tags will be
available for completion.
(org-columns-edit-value)
(org-columns-next-allowed-value): Only update if not in agenda.
(org-dblock-write:clocktable): Call `org-clocktable-steps'.
(org-archive-subtree): Add the outline tree context as a property.
(org-closest-date): New optional argument `prefer'.
(org-goto-map, org-get-location): Implement auto-isearch.
(org-goto-local-search-forward-headings)
(org-get-entries-from-diary): Require diary-lib.
(org-agenda-sunrise-sunset): Require solar.
(org-export-html-style): Doc fix.
(org-get-legal-level): New obsolete alias.
(org-get-valid-level): Rename from `org-get-legal-level'.
(org-promote, org-demote, org-archive-subtree)
(org-remember-handler, org-refile, org-put-clock-overlay): Use it.
(org-info): Use info rather than Info-goto-node.
(org-entry-properties): Let-bind `clocksum'.
(org-unmodified, org-cycle-emulate-tab)
(org-descriptive-links, org-link-file-path-type)
(org-remember-use-refile-when-interactive)
(org-agenda-skip-timestamp-if-done, org-agenda-scheduled-leaders)
(org-export-ascii-bullets, org-agenda-deadline-faces)
(turn-on-orgstruct++, orgtbl-to-texinfo, org-mhe-get-header)
(org-batch-agenda, org-batch-agenda-csv, org-fix-agenda-info)
(org-kill-note-or-show-branches): Fix typos in docstrings.
(org-html-do-expand): `org-export-html-convert-special-strings'
added to the list of conversion.
(org-infile-export-plist, org-get-current-options): Add support
for "-" in the #+OPTION line to let user switch on/off special
strings conversion.
(org-export-plist-vars): New :html-table-tag property.
(org-export-as-html, org-format-org-table-html)
(org-format-table-table-html) Use the :html-table-tag property
instead of the `org-export-html-table-tag' global value.
(org-additional-option-like-keywords): Add "TBLFM".
(org-entry-properties): Include the CLOCKSUM special property.
(org-columns-edit-value): Do not allow to edit the special
CLOCKSUM property.
(org-flag-drawer): Use the original value of `outline-regexp'.
(org-remember-handler): Add invisible-ok flag to call to
`org-end-of-subtree'.
(org-agenda-highlight-todo): Respect
`org-agenda-todo-keyword-format'.
(org-infile-export-plist): No restriction while searching for
options.
(org-remember-handler): Remove comments at the end of the buffer.
(org-table-sort-lines): Make sure sorting works on link
descritions only, and ignores the link.
(org-sort-entries-or-items): Make sure the end of the subtree is
included.
(org-refile-use-outline-path): New allowed values `file' and
`full-file-path'.
(org-get-refile-targets): Respect new values for
`org-refile-use-outline-path'.
(org-agenda-get-restriction-and-command): DEL goes back to initial
list.
(org-export-as-xoxo): Restore point when done.
(org-open-file): Allow multiple %s in command.
(org-get-refile-targets): Interpret the new maxlevel setting.
(org-refile-targets): New option `:maxlevel'.
(org-copy-subtree): Include empty lines before but not after
subtree.
(org-move-item-down, org-move-item-up): Include empty lines before
but not after item.
(org-remember-apply-template): Defaults, completions and history
for template prompts. Also, interpret new `%!' escape.
(org-context-choices): New constant.
(org-bound-and-true-p): New macro.
(org-agenda-restriction-lock): New face.
(org-open-at-point): Remove obsolete way to do redirection in
shell links.
(org-imenu-and-speedbar): New customization group.
(org-entry-properties): Return keyword-less time strings.
(org-clock-in): Use `org-clock-heading-function'.
(org-calendar-holiday): Try to use `calendar-check-holidays'
instead of the obsolete `check-calendar-holidays'.
(org-export-html-special-string-regexps): New constant.
(org-latex-and-export-specials): New face.
(org-link-escape-chars): Use characters instead of strings.
(org-link-escape-chars-browser, org-link-escape)
(org-link-unescape): Use characters instead of strings.
(org-export-html-convert-sub-super, org-html-do-expand): Check for
protected text.
(org-emphasis-alist): Additional `verbatim' flag.
(org-set-emph-re): Handle the verbatim flag and compute
`org-verbatim-re'.
(org-cleaned-string-for-export): Protect verbatim elements.
(org-additional-option-like-keywords): Add new keywords.
(org-get-entry): Rename from `org-get-cleaned-entry'.
(org-agenda-get-scheduled, org-agenda-get-blocks): Use
`org-agenda-skip-scheduled-if-done'.
(org-prepare-agenda-buffers): Allow buffers as arguments.
(org-entry-properties): Add CATEGORY as a special property.
(org-use-property-inheritance): Allow a list of properties as a
value.
(org-eval-in-calendar): No longer update the prompt.
(org-read-date-popup-calendar): Rename from
`org-popup-calendar-for-date-prompt'.
(org-remember-apply-template): Define `remember-finalize' if it is
not yet defined.
(org-read-date): Respect the setting of
`org-read-date-prefer-future'. Use `org-read-date-analyze'.
(org-set-font-lock-defaults): Use `org-archive-tag' instead of a
hardcoded string.
(org-remember-apply-template): Use `remember-finalize' instead of
`remember-buffer'.
(org-columns-compute, org-column-number-to-string)
(org-columns-uncompile-format, org-columns-compile-format)
(org-columns-compile-format): Handle printf format specifier.
(org-columns-new, org-column-number-to-string)
(org-columns-uncompile-format, org-columns-compile-format):
Support for new currency summary type.
(org-tree-to-indirect-buffer): Do not kill old buffer when
`org-indirect-buffer-display' is `new-frame'.
(org-indirect-buffer-display): Document that `new-frame' leads to
indiret buffer proliferation.
(org-agenda-list): Use `org-extend-today-until'.
(org-format-org-table-html): Use lower-case for <col> tag.
(org-agenda-execute): New command.
(org-agenda-mode-map): Keybindings of "g" "G", "e" modified.
(org-remember-apply-template): Use `org-select-remember-template'.
(org-region-active-p): Use `use-region-p'.
(org-cycle-hide-archived-subtrees)
(org-table-rotate-recalc-marks, org-mark-ring-push)
(org-follow-info-link, org-mhe-get-message-folder-from-index)
(org-auto-repeat-maybe, org-store-log-note, org-delete-property)
(org-evaluate-time-range, org-edit-agenda-file-list):
(org-paste-subtree):
(org-calendar-holiday): Use calendar-check-holidays instead of the
obsolete check-calendar-holidays.
(org-table-formula-substitute-names): Remove forgotten temporary
debugging code.
(org-agenda-get-restriction-and-command): Use `mapc' instead of
`mapcar'.
(org-agenda-list): Numeric prefix argument can specify the number
of days.
(remember-register, remember-buffer): Prevent byte compiler from
complaining.
(org-todo): Save and restore match data.
(org-no-warnings): New macro.
(org-columns-eval): Use `org-no-warnings'.
(org-version): Change to 5.13e.
(org-agenda-file-regexp): Fix typo in docstring.
(org-add-planning-info): Fix bug in parenthesis settings.
(org-scan-tags): Catch the case of indirect buffers with no
filename.
(org-fast-tag-selection, org-export-as-ascii, org-export-as-html):
Re-install switch to mapc, had been removed by accident.
(org-columns-map): New binding `C-c C-o'.
(org-columns-menu): Change menu text and added new entry.
(org-columns-eval): Document the use of `next-line'.
(org-columns-follow-link): Remove function.
(org-read-date-get-relative): Fix typo in docstring.
(org-read-date-get-relative): Leading +/- is not optional.
(org-agenda-get-restriction-and-command): Always resize window on
first loop cycle.
(org-agenda-open-link): Make sure the link abbreviations are
present in the agenda buffer.
(org-agenda-files): Allow directories in the variable.
(org-agenda): Use `org-agenda-get-restriction-and-command'.
(org-todo-blocker-hook, org-todo-trigger-hook): New hooks.
(org-remember-apply-template): Catch C-g and make sure window
configuration is restored.
(org-agenda-open-link): Make it work with several links in the
line.
(org-drawers, org-set-regexps-and-options)
(org-get-current-options): Add support for a DRAWERS in-buffer
option.
(org-fit-agenda-window): Use `org-agenda-window-frame-fractions'.
(org-agenda-to-appt): Require calendar.
(org-entry-get-with-inheritance): Widen for search.
(org-columns-display-here): Don't mark buffer as modified when
adding space characters to accomodate column overlays.
(org-export-as-html): Better formatting of tags in the toc.
(org-columns-display-here): Make the ITEM column as compact as
possible.
(org-remember-templates): Customization interface improved.
(org-export-with-property-drawer): Variable removed.
(org-sort-entries): Rewrite using `sort-subr'.
(org-set-property): More appropriate completion during interactive
use.
(org-sort-entries): Allow sorting by property.
(org-additional-option-like-keywords): Add more values.
(org-sort-entries-or-items): Rename from `org-sort-entries'.
(org-at-timestamp-p, org-timestamp-change)
(org-remember-templates): First element of each entry is now a
name for the template.
(org-store-log-note): Check for `org-note-abort'.
(org-kill-note-or-show-branches): New command.
(org-cut-subtree, org-copy-subtree): New argument N to act on N
sequential subtrees.
(org-paste-subtree): Fix the level at which a tree is pasted.
(org-fit-agenda-window): Limitations on window size removed.
(org-agenda-find-same-or-today-or-agenda): Rename from
`org-agenda-find-today-or-agenda'.
(org-agenda-scheduled-leaders)
(org-agenda-get-deadlines): Use `org-agenda-deadline-leaders'.
(org-agenda-get-scheduled): Use `org-agenda-scheduled-leaders'.
(org-export-with-tags, org-export-plist-vars)
(org-infile-export-plist): New "tags" option.
(org-cached-entry-get): Use `org-use-property-inheritance'.
(org-remember-apply-template): Fix typo.
(org-additional-option-like-keywords): New constant.
(org-complete): Use `org-additional-option-like-keywords'.
(org-clock-report): Only update the table at point, or insert a
new one.
(org-open-file): Use `start-process-shell-command' instead of
`shell-command' with an ampersand.
(org-deadline, org-schedule): New argument REMOVE to remove the
date from the entry.
(org-agenda-schedule, org-agenda-deadline): Pass the prefix
argument to `org-schedule' and `org-deadline'.
(org-trim): Use the correct expressions for beginning and end of
the string.
(org-get-cleaned-entry): Trim the string before returning it.
(org-agenda-tags-column): Rename from
`org-agenda-align-tags-to-column'.
(org-agenda-align-tags): Allow negative values for
`org-agenda-tags-column'.
(org-insert-labeled-timestamps-before-properties-drawer): Remove
var.
(org-agenda-to-appt): New optional argument FILTER.
(org-complete): Use `org-completion-fallback-command'.
(org-find-base-buffer-visiting): Catch the case that there is no
buffer visiting the file.
(org-todo): Use `org-property-or-variable-value'
(org-prepare-agenda, org-agenda-list): Use
`org-agenda-compact-blocks'.
(org-agenda-schedule, org-agenda-deadline): Call
`org-agenda-show-new-time'.
(org-agenda-show-new-time): New argument PREFIX.
(org-colgroup-info-to-vline-list): Fix but that cause a shift in
the vertical lines.
(org-buffer-property-keys): New argument INCLUDE-DEFAULTS.
(org-maybe-renumber-ordered-list, org-cycle-list-bullet)
(org-indent-item): No arg in call to `org-fix-bullet-type'.
(org-fix-bullet-type): Remove argument.
(org-read-date): Check for am/pm twice, to catch the end time.
(org-goto-map): Use `suppress-keymap'.
(org-remember-apply-template): Respect the dynamically scoped
selection character.
(org-kill-is-subtree-p): Use `org-outline-regexp'.
(org-outline-regexp): New constant.
(org-remember-handler): Throw error when the target file is not in
org-mode.
(org-cleaned-string-for-export): No longer call
`org-export-latex-cleaned-string' with an argument.
(org-get-tags): Returns now a list, not a string.
(org-archive-subtree): No need to split return of `org-get-tags'.
(org-set-tags, org-entry-properties): Call `org-get-tags-string'
instead of `org-get-tags'.
(org-agenda-format-date): Rename from `org-agenda-date-format'.
(org-time-from-absolute, org-agenda-format-date-aligned): New
funs.
(org-compatible-face): New argument INHERITS. Inherit from this
face if possible.
(org-level-1, org-level-2, org-level-3, org-level-4)
(org-level-5, org-level-6, org-level-7, org-level-8)
(org-special-keyword, org-drawer, org-column, org-warning)
(org-archived, org-todo, org-done, org-headline-done, org-table)
(org-formula, org-code, org-agenda-structure)
(org-scheduled-today, org-scheduled-previously)
(org-upcoming-deadline, org-time-grid): Call `org-compatible-face'
in the new way.
(org-get-heading): New argument NO-TAGS.
(org-fast-tag-selection-include-todo): Made defvar instead of
defcustom, feature is not deprecated.
(org-remember-store-without-prompt): New default value t.
(org-set-regexps-and-options): #+TODO is an alias for SEQ_TODO.
Compute the log states.
(org-goto-map): More commands copied from global map. Also bind
`org-occur'.
(org-goto): Made into a general lookup command.
(org-get-location): Complete rewrite.
(org-goto-ret, org-goto-left, org-goto-right, org-goto-quit): Set
the new variables.
(org-paste-subtree): Whitespace insertion strategy revised.
(org-remember-apply-template): Protect v-A from the possibility
that v-a might be nil.
(org-remember-handler): Insertion rules revised.
(org-todo): Respect org-todo-log-states.
(org-entry-get-with-inheritance): Use `org-up-heading-safe'.
(org-confirm-shell-link-function)
(org-confirm-elisp-link-function): Doc fixes.
(org-re): Also replace the :alpha: class.
(org-todo-tag-alist): Variable removed.
(org-log-done): Docstring fixed.
(org-deadline-warning-days): New default value 14.
(org-tag-alist): Docstring fixed.
(org-export-language-setup): New languages added.
(org-set-regexps-and-options): Compute the new variables.
(org-paste-subtree): Cleaning up.
(org-remember-apply-template): New escape %A.
(org-todo): Call fast TODO selection.
(org-add-log-note): Allow prefix for abort exit.
(org-at-property-p, org-entry-properties)
(org-columns-get-autowidth-alist): Use :alpha: class.
(org-agenda-get-deadlines): Use `org-get-wdays'.
(org-agenda-get-deadlines): Reverse ee before returning.
(org-format-agenda-item): New argument REMOVE-RE.
(org-agenda-convert-date): Baha'i calendar added.
(org-infile-export-plist): Also find DATE line.
(org-export-as-html, org-export-as-ascii): Use the date format.
(org-shiftup, org-shiftdown): Use.
`org-edit-timestamp-down-means-later'.
(org-columns-compile-format)
(org-columns-get-autowidth-alist, org-buffer-property-keys)
(org-entry-properties, org-at-property-p): Allow [:alnum:] in
property names.
(org-export-visible): Fix drawers before export.
(org-do-sort): Allow sorting by priority.
(org-agenda-files): Ignore non-existing files.
(org-ellipsis): All a face as value.
(org-mode): Interprete the face value of `org-ellipsis'.
(org-archive-subtree): Store context info in archived entry.
(org-fast-tag-selection): Allow setting TODO states through this
interface.
(org-cycle): Docstring updated.
(org-set-font-lock-defaults, org-agenda-highlight-todo): Use
`org-get-todo-face'.
(org-table-edit-field, org-table-show-reference)
(org-table-edit-formulas, org-add-log-note)
(org-fast-tag-selection, org-agenda, org-prepare-agenda)
(org-timeline): Use `org-switch-to-buffer-other-window' instead of
`switch-to-buffer-other-window' to make sure that the temporary
windows show up on the current frame.
(org-mhe-get-message-real-folder, org-batch-store-agenda-views)
(org-get-entries-from-diary, org-replace-region-by-html): Don't
allow pop-up frames.
(org-agenda-get-deadlines, org-agenda-get-scheduled): Fix problems
with time-of-day.
(org-agenda-get-scheduled, org-agenda-get-deadlines): Fix problems
with listing items that are DONE.
(org-change-tag-in-region): New command.
(org-agenda-skip-scheduled-if-done)
(org-agenda-skip-deadline-if-done): Docstring clarified.
(org-mode): Hide drawers on startup.
(org-set-regexps-and-options): Use `org-remove-keyword-keys'.
(org-agenda-skip): Allow a form for `org-agenda-skip-function'.
(org-agenda-redo): Re-use local settings.
(org-agenda): Store local settings.
(org-agenda-get-deadlines, org-agenda-get-scheduled): Also handle
entries on their due date.
(org-agenda-get-timestamps): No longer handle the due dates of
schedules and deadline items.
(org-insert-link-global, org-open-at-point-global): New commands.
(org-export-as-ascii): Call `org-cleaned-string-for-export' with a
:for-ascii parameter.
(org-skip-comments): Function removed.
(org-cleaned-string-for-export): Handle special table lines.
(org-entry-get-with-inheritance): Check global properties.
(org-set-regexps-and-options): Find the #+PROPERTY line.
(org-link-types): Change type into variable (was constant).
(org-link-re-with-space, org-link-re-with-space2)
(org-angle-link-re, org-plain-link-re, org-bracket-link-regexp)
(org-bracket-link-analytic-regexp, org-any-link-re): Creation of
these regular expressions happens now in the function
`org-make-link-regexps'.
(org-store-link): Call the functions in
`org-store-link-functions'.
(org-activate-tags): Force matches to be in headlines.
(org-batch-store-agenda-views): Fix bug with killing agenda
buffer.
(org-columns-display-here): Make sure this works in a narrowed
buffer by checking for point-min.
(org-columns-display-here): Make the rest of the line intangible,
so that point never can be there.
(org-cleaned-string-for-export): Use `with-current-buffer'.
(org-replace-region-by-html): Use `with-current-buffer'.
(org-unfontify-region, org-do-occur, org-columns-display-here)
(org-columns-remove-overlays, org-columns-quit)
(org-columns-edit-value, org-columns-next-allowed-value)
(org-eval-in-calendar, org-agenda-undo, org-no-read-only)
(org-finalize-agenda, org-remove-subtree-entries-from-agenda)
(org-agenda-todo, org-agenda-change-all-lines)
(org-agenda-align-tags, org-agenda-priority)
(org-agenda-set-tags, org-agenda-toggle-archive-tag)
(org-agenda-show-new-time, org-cleaned-string-for-export)
(org-export-grab-title-from-buffer)
(org-export-as-ascii, org-export-as-html): Use `inhibit-read-only'
instead of `buffer-read-only'.
(org-export-as-html): Set `coding-system-for-write'.
(org-archive-subtree): Fixed bug with modifying TODO keyword.
(org-beginning-of-line): Also treat C-a special in items.
(org-table-convert-refs-to-rc): Fixed problem with column
reference after "..".
(org-columns-compute): Don't mark buffer modified because of text
properties.
(org-batch-store-agenda-views): Use the variable
`default-directory', not the function.
(org-clock-out-if-current): Respect `org-clock-out-when-done'.
(org-html-entities): Added HTML entities for smileys.
(org-end-of-line): Move to end of line if in headline without
tags.
(org-agenda-day-view, org-agenda-week-view): Remember span as
default.
(org-columns-edit-value): Rename from `org-column-edit'.
(org-columns-display-here-title): Rename from
`org-overlay-columns-title'.
(org-columns-remove-overlays): Rename from
org-remove-column-overlays.
(org-columns-get-autowidth-alist): Rename from
`org-get-columns-autowidth-alist'.
(org-columns-display-here): Rename from `org-overlay-columns'.
(org-columns-new-overlay): Rename from `org-new-column-overlay'.
(org-columns-quit): Rename from `org-column-quit'.
(org-columns-show-value): Rename from `org-column-show-value'.
(org-columns-current-fmt): Rename from `org-current-columns-fmt'.
(org-columns-overlays): Rename from `org-column-overlays'.
(org-columns-map): Rename from `org-column-map'.
(org-columns-current-maxwidths): Rename from
`org-current-columns-maxwidths'.
(org-columns-begin-marker, org-columns-current-fmt-compiled)
(org-previous-header-line-format)
(org-columns-inhibit-recalculation)
(org-columns-default-format): Rename from
`org-default-columns-format'.
(org-property-re): New constant.
(orgstruct-mode): New minor mode.
(org-cycle-list-bullet): New command.
(org-special-properties, org-property-start-re)
(org-property-end-re): New constants.
(org-with-point-at): New macro.
(org-insert-property-drawer): New command.
(org-column): New face.
(org-column-menu): New menu.
(org-columns, org-agenda-columns): New commands.
(org-properties): New customize group.
(org-priority): Realign tags after changing priority.
(org-preserve-lc): New macro.
(org-update-checkbox-count): Catch case when there is no headline.
(org-agenda-quit): Remove any column overlays.
(org-beginning-of-item-list): Fixed bug when non-item line is
indented too deep.
(org-make-tags-matcher): Handle property matches.
(org-table-recalculate): Swap evaluation order: Field formula
first, then column formulas, but don't allow them to overwrite the
field formulas.
(org-table-eval-formula): New argument untouchable.
(org-export-as-html): Fix replacement bug for XEmacs.
author | Carsten Dominik <dominik@science.uva.nl> |
---|---|
date | Tue, 08 Apr 2008 07:44:50 +0000 |
parents | 86666002b78d |
children |
line wrap: on
line source
@c This is part of the Emacs manual. @c Copyright (C) 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @c @c This file is included either in emacs-xtra.texi (when producing the @c printed version) or in the main Emacs manual (for the on-line version). @node MS-DOS @section Emacs and MS-DOS @cindex MS-DOG @cindex MS-DOS peculiarities This section briefly describes the peculiarities of using Emacs on the MS-DOS ``operating system'' (also known as ``MS-DOG''). @iftex Information about Emacs and Microsoft's current operating system Windows (also known as ``Losedows'') is in the main Emacs manual (@pxref{Microsoft Systems,,, emacs, the Emacs Manual}). @end iftex @ifnottex Information about peculiarities common to MS-DOS and Microsoft's current operating systems Windows (also known as ``Losedows'') is in @ref{Microsoft Windows}. @end ifnottex If you build Emacs for MS-DOS, the binary will also run on Windows 3.X, Windows NT, Windows 9X/ME, Windows 2000/XP, or OS/2 as a DOS application; all of this chapter applies for all of those systems, if you use an Emacs that was built for MS-DOS. @iftex @xref{Text and Binary,,,emacs, the Emacs Manual}, for information @end iftex @ifnottex @xref{Text and Binary}, for information @end ifnottex about Emacs' special handling of text files under MS-DOS (and Windows). @menu * Keyboard: MS-DOS Keyboard. Keyboard conventions on MS-DOS. * Mouse: MS-DOS Mouse. Mouse conventions on MS-DOS. * Display: MS-DOS Display. Fonts, frames and display size on MS-DOS. * Files: MS-DOS File Names. File name conventions on MS-DOS. * Printing: MS-DOS Printing. Printing specifics on MS-DOS. * I18N: MS-DOS and MULE. Support for internationalization on MS-DOS. * Processes: MS-DOS Processes. Running subprocesses on MS-DOS. @end menu @node MS-DOS Keyboard @subsection Keyboard Usage on MS-DOS @kindex DEL @r{(MS-DOS)} @kindex BS @r{(MS-DOS)} The key that is called @key{DEL} in Emacs (because that's how it is designated on most workstations) is known as @key{BS} (backspace) on a PC. That is why the PC-specific terminal initialization remaps the @key{BS} key to act as @key{DEL}; the @key{DELETE} key is remapped to act as @kbd{C-d} for the same reasons. @kindex C-g @r{(MS-DOS)} @kindex C-BREAK @r{(MS-DOS)} @cindex quitting on MS-DOS Emacs built for MS-DOS recognizes @kbd{C-@key{BREAK}} as a quit character, just like @kbd{C-g}. This is because Emacs cannot detect that you have typed @kbd{C-g} until it is ready for more input. As a consequence, you cannot use @kbd{C-g} to stop a running command @iftex (@pxref{Quitting,,,emacs, the Emacs Manual}). @end iftex @ifnottex (@pxref{Quitting}). @end ifnottex By contrast, @kbd{C-@key{BREAK}} @emph{is} detected as soon as you type it (as @kbd{C-g} is on other systems), so it can be used to stop a running command and for emergency escape @iftex (@pxref{Emergency Escape,,,emacs, the Emacs Manual}). @end iftex @ifnottex (@pxref{Emergency Escape}). @end ifnottex @cindex Meta (under MS-DOS) @cindex Hyper (under MS-DOS) @cindex Super (under MS-DOS) @vindex dos-super-key @vindex dos-hyper-key The PC keyboard maps use the left @key{ALT} key as the @key{META} key. You have two choices for emulating the @key{SUPER} and @key{HYPER} keys: choose either the right @key{CTRL} key or the right @key{ALT} key by setting the variables @code{dos-hyper-key} and @code{dos-super-key} to 1 or 2 respectively. If neither @code{dos-super-key} nor @code{dos-hyper-key} is 1, then by default the right @key{ALT} key is also mapped to the @key{META} key. However, if the MS-DOS international keyboard support program @file{KEYB.COM} is installed, Emacs will @emph{not} map the right @key{ALT} to @key{META}, since it is used for accessing characters like @kbd{~} and @kbd{@@} on non-US keyboard layouts; in this case, you may only use the left @key{ALT} as @key{META} key. @kindex C-j @r{(MS-DOS)} @vindex dos-keypad-mode The variable @code{dos-keypad-mode} is a flag variable that controls what key codes are returned by keys in the numeric keypad. You can also define the keypad @key{ENTER} key to act like @kbd{C-j}, by putting the following line into your @file{_emacs} file: @smallexample ;; @r{Make the @key{ENTER} key from the numeric keypad act as @kbd{C-j}.} (define-key function-key-map [kp-enter] [?\C-j]) @end smallexample @node MS-DOS Mouse @subsection Mouse Usage on MS-DOS @cindex mouse support under MS-DOS Emacs on MS-DOS supports a mouse (on the default terminal only). The mouse commands work as documented, including those that use menus and the menu bar @iftex (@pxref{Menu Bar,,,emacs, the Emacs Manual}). @end iftex @ifnottex (@pxref{Menu Bar}). @end ifnottex Scroll bars don't work in MS-DOS Emacs. PC mice usually have only two buttons; these act as @kbd{Mouse-1} and @kbd{Mouse-2}, but if you press both of them together, that has the effect of @kbd{Mouse-3}. If the mouse does have 3 buttons, Emacs detects that at startup, and all the 3 buttons function normally, as on X. Help strings for menu-bar and pop-up menus are displayed in the echo area when the mouse pointer moves across the menu items. Highlighting of mouse-sensitive text @iftex (@pxref{Mouse References,,,emacs, the Emacs Manual}) @end iftex @ifnottex (@pxref{Mouse References}) @end ifnottex is also supported. @cindex mouse, set number of buttons @findex msdos-set-mouse-buttons Some versions of mouse drivers don't report the number of mouse buttons correctly. For example, mice with a wheel report that they have 3 buttons, but only 2 of them are passed to Emacs; the clicks on the wheel, which serves as the middle button, are not passed. In these cases, you can use the @kbd{M-x msdos-set-mouse-buttons} command to tell Emacs how many mouse buttons to expect. You could make such a setting permanent by adding this fragment to your @file{_emacs} init file: @example ;; @r{Treat the mouse like a 2-button mouse.} (msdos-set-mouse-buttons 2) @end example @cindex Windows clipboard support Emacs built for MS-DOS supports clipboard operations when it runs on Windows. Commands that put text on the kill ring, or yank text from the ring, check the Windows clipboard first, just as Emacs does on the X Window System @iftex (@pxref{Mouse Commands,,,emacs, the Emacs Manual}). @end iftex @ifnottex (@pxref{Mouse Commands}). @end ifnottex Only the primary selection and the cut buffer are supported by MS-DOS Emacs on Windows; the secondary selection always appears as empty. Due to the way clipboard access is implemented by Windows, the length of text you can put into the clipboard is limited by the amount of free DOS memory that is available to Emacs. Usually, up to 620KB of text can be put into the clipboard, but this limit depends on the system configuration and is lower if you run Emacs as a subprocess of another program. If the killed text does not fit, Emacs outputs a message saying so, and does not put the text into the clipboard. Null characters also cannot be put into the Windows clipboard. If the killed text includes null characters, Emacs does not put such text into the clipboard, and displays in the echo area a message to that effect. @vindex dos-display-scancodes The variable @code{dos-display-scancodes}, when non-@code{nil}, directs Emacs to display the @acronym{ASCII} value and the keyboard scan code of each keystroke; this feature serves as a complement to the @code{view-lossage} command, for debugging. @node MS-DOS Display @subsection Display on MS-DOS @cindex faces under MS-DOS @cindex fonts, emulating under MS-DOS Display on MS-DOS cannot use font variants, like bold or italic, but it does support multiple faces, each of which can specify a foreground and a background color. Therefore, you can get the full functionality of Emacs packages that use fonts (such as @code{font-lock}, Enriched Text mode, and others) by defining the relevant faces to use different colors. Use the @code{list-colors-display} command @iftex (@pxref{Frame Parameters,,,emacs, the Emacs Manual}) @end iftex @ifnottex (@pxref{Frame Parameters}) @end ifnottex and the @code{list-faces-display} command @iftex (@pxref{Faces,,,emacs, the Emacs Manual}) @end iftex @ifnottex (@pxref{Faces}) @end ifnottex to see what colors and faces are available and what they look like. @xref{MS-DOS and MULE}, later in this chapter, for information on how Emacs displays glyphs and characters that aren't supported by the native font built into the DOS display. @cindex cursor shape on MS-DOS When Emacs starts, it changes the cursor shape to a solid box. This is for compatibility with other systems, where the box cursor is the default in Emacs. This default shape can be changed to a bar by specifying the @code{cursor-type} parameter in the variable @code{default-frame-alist} @iftex (@pxref{Creating Frames,,,emacs, the Emacs Manual}). @end iftex @ifnottex (@pxref{Creating Frames}). @end ifnottex The MS-DOS terminal doesn't support a vertical-bar cursor, so the bar cursor is horizontal, and the @code{@var{width}} parameter, if specified by the frame parameters, actually determines its height. For this reason, the @code{bar} and @code{hbar} cursor types produce the same effect on MS-DOS. As an extension, the bar cursor specification can include the starting scan line of the cursor as well as its width, like this: @example '(cursor-type bar @var{width} . @var{start}) @end example @noindent In addition, if the @var{width} parameter is negative, the cursor bar begins at the top of the character cell. @cindex frames on MS-DOS The MS-DOS terminal can only display a single frame at a time. The Emacs frame facilities work on MS-DOS much as they do on text-only terminals @iftex (@pxref{Frames,,,emacs, the Emacs Manual}). @end iftex @ifnottex (@pxref{Frames}). @end ifnottex When you run Emacs from a DOS window on MS-Windows, you can make the visible frame smaller than the full screen, but Emacs still cannot display more than a single frame at a time. @cindex frame size under MS-DOS @findex mode4350 @findex mode25 The @code{mode4350} command switches the display to 43 or 50 lines, depending on your hardware; the @code{mode25} command switches to the default 80x25 screen size. By default, Emacs only knows how to set screen sizes of 80 columns by 25, 28, 35, 40, 43 or 50 rows. However, if your video adapter has special video modes that will switch the display to other sizes, you can have Emacs support those too. When you ask Emacs to switch the frame to @var{n} rows by @var{m} columns dimensions, it checks if there is a variable called @code{screen-dimensions-@var{n}x@var{m}}, and if so, uses its value (which must be an integer) as the video mode to switch to. (Emacs switches to that video mode by calling the BIOS @code{Set Video Mode} function with the value of @code{screen-dimensions-@var{n}x@var{m}} in the @code{AL} register.) For example, suppose your adapter will switch to 66x80 dimensions when put into video mode 85. Then you can make Emacs support this screen size by putting the following into your @file{_emacs} file: @example (setq screen-dimensions-66x80 85) @end example Since Emacs on MS-DOS can only set the frame size to specific supported dimensions, it cannot honor every possible frame resizing request. When an unsupported size is requested, Emacs chooses the next larger supported size beyond the specified size. For example, if you ask for 36x80 frame, you will get 40x80 instead. The variables @code{screen-dimensions-@var{n}x@var{m}} are used only when they exactly match the specified size; the search for the next larger supported size ignores them. In the above example, even if your VGA supports 38x80 dimensions and you define a variable @code{screen-dimensions-38x80} with a suitable value, you will still get 40x80 screen when you ask for a 36x80 frame. If you want to get the 38x80 size in this case, you can do it by setting the variable named @code{screen-dimensions-36x80} with the same video mode value as @code{screen-dimensions-38x80}. Changing frame dimensions on MS-DOS has the effect of changing all the other frames to the new dimensions. @node MS-DOS File Names @subsection File Names on MS-DOS @cindex file names under MS-DOS @cindex init file, default name under MS-DOS On MS-DOS, file names are case-insensitive and limited to eight characters, plus optionally a period and three more characters. Emacs knows enough about these limitations to handle file names that were meant for other operating systems. For instance, leading dots @samp{.} in file names are invalid in MS-DOS, so Emacs transparently converts them to underscores @samp{_}; thus your default init file @iftex (@pxref{Init File,,,emacs, the Emacs Manual}) @end iftex @ifnottex (@pxref{Init File}) @end ifnottex is called @file{_emacs} on MS-DOS. Excess characters before or after the period are generally ignored by MS-DOS itself; thus, if you visit the file @file{LongFileName.EvenLongerExtension}, you will silently get @file{longfile.eve}, but Emacs will still display the long file name on the mode line. Other than that, it's up to you to specify file names which are valid under MS-DOS; the transparent conversion as described above only works on file names built into Emacs. @cindex backup file names on MS-DOS The above restrictions on the file names on MS-DOS make it almost impossible to construct the name of a backup file @iftex (@pxref{Backup Names,,,emacs, the Emacs Manual}) @end iftex @ifnottex (@pxref{Backup Names}) @end ifnottex without losing some of the original file name characters. For example, the name of a backup file for @file{docs.txt} is @file{docs.tx~} even if single backup is used. @cindex file names under Windows 95/NT @cindex long file names in DOS box under Windows 95/NT If you run Emacs as a DOS application under Windows 9X, Windows ME, or Windows 2000/XP, you can turn on support for long file names. If you do that, Emacs doesn't truncate file names or convert them to lower case; instead, it uses the file names that you specify, verbatim. To enable long file name support, set the environment variable @env{LFN} to @samp{y} before starting Emacs. Unfortunately, Windows NT doesn't allow DOS programs to access long file names, so Emacs built for MS-DOS will only see their short 8+3 aliases. @cindex @env{HOME} directory under MS-DOS MS-DOS has no notion of home directory, so Emacs on MS-DOS pretends that the directory where it is installed is the value of the @env{HOME} environment variable. That is, if your Emacs binary, @file{emacs.exe}, is in the directory @file{c:/utils/emacs/bin}, then Emacs acts as if @env{HOME} were set to @samp{c:/utils/emacs}. In particular, that is where Emacs looks for the init file @file{_emacs}. With this in mind, you can use @samp{~} in file names as an alias for the home directory, as you would on GNU or Unix. You can also set @env{HOME} variable in the environment before starting Emacs; its value will then override the above default behavior. Emacs on MS-DOS handles the directory name @file{/dev} specially, because of a feature in the emulator libraries of DJGPP that pretends I/O devices have names in that directory. We recommend that you avoid using an actual directory named @file{/dev} on any disk. @node MS-DOS Printing @subsection Printing and MS-DOS Printing commands, such as @code{lpr-buffer} @iftex (@pxref{Printing,,,emacs, the Emacs Manual}) and @code{ps-print-buffer} (@pxref{PostScript,,,emacs, the Emacs Manual}) @end iftex @ifnottex (@pxref{Printing}) and @code{ps-print-buffer} (@pxref{PostScript}) @end ifnottex can work on MS-DOS by sending the output to one of the printer ports, if a Posix-style @code{lpr} program is unavailable. The same Emacs variables control printing on all systems, but in some cases they have different default values on MS-DOS. @iftex @xref{Windows Printing,,,emacs, the Emacs Manual}, @end iftex @ifnottex @xref{Windows Printing}, @end ifnottex for details about setting up printing to a networked printer. Some printers expect DOS codepage encoding of non-@acronym{ASCII} text, even though they are connected to a Windows machine which uses a different encoding for the same locale. For example, in the Latin-1 locale, DOS uses codepage 850 whereas Windows uses codepage 1252. @xref{MS-DOS and MULE}. When you print to such printers from Windows, you can use the @kbd{C-x RET c} (@code{universal-coding-system-argument}) command before @kbd{M-x lpr-buffer}; Emacs will then convert the text to the DOS codepage that you specify. For example, @kbd{C-x RET c cp850-dos RET M-x lpr-region RET} will print the region while converting it to the codepage 850 encoding. You may need to create the @code{cp@var{nnn}} coding system with @kbd{M-x codepage-setup}. @vindex dos-printer @vindex dos-ps-printer For backwards compatibility, the value of @code{dos-printer} (@code{dos-ps-printer}), if it has a value, overrides the value of @code{printer-name} (@code{ps-printer-name}), on MS-DOS. @node MS-DOS and MULE @subsection International Support on MS-DOS @cindex international support @r{(MS-DOS)} Emacs on MS-DOS supports the same international character sets as it does on GNU, Unix and other platforms @iftex (@pxref{International,,,emacs, the Emacs Manual}), @end iftex @ifnottex (@pxref{International}), @end ifnottex including coding systems for converting between the different character sets. However, due to incompatibilities between MS-DOS/MS-Windows and other systems, there are several DOS-specific aspects of this support that you should be aware of. This section describes these aspects. The description below is largely specific to the MS-DOS port of Emacs, especially where it talks about practical implications for Emacs users. For other operating systems, see the @file{code-pages.el} package, which implements support for MS-DOS- and MS-Windows-specific encodings for all platforms other than MS-DOS. @table @kbd @item M-x dos-codepage-setup Set up Emacs display and coding systems as appropriate for the current DOS codepage. @item M-x codepage-setup Create a coding system for a certain DOS codepage. @end table @cindex codepage, MS-DOS @cindex DOS codepages MS-DOS is designed to support one character set of 256 characters at any given time, but gives you a variety of character sets to choose from. The alternative character sets are known as @dfn{DOS codepages}. Each codepage includes all 128 @acronym{ASCII} characters, but the other 128 characters (codes 128 through 255) vary from one codepage to another. Each DOS codepage is identified by a 3-digit number, such as 850, 862, etc. In contrast to X, which lets you use several fonts at the same time, MS-DOS normally doesn't allow use of several codepages in a single session. MS-DOS was designed to load a single codepage at system startup, and require you to reboot in order to change it@footnote{Normally, one particular codepage is burnt into the display memory, while other codepages can be installed by modifying system configuration files, such as @file{CONFIG.SYS}, and rebooting. While there is third-party software that allows changing the codepage without rebooting, we describe here how a stock MS-DOS system behaves.}. Much the same limitation applies when you run DOS executables on other systems such as MS-Windows. @cindex unibyte operation @r{(MS-DOS)} If you invoke Emacs on MS-DOS with the @samp{--unibyte} option @iftex (@pxref{Initial Options,,,emacs, the Emacs Manual}), @end iftex @ifnottex (@pxref{Initial Options}), @end ifnottex Emacs does not perform any conversion of non-@acronym{ASCII} characters. Instead, it reads and writes any non-@acronym{ASCII} characters verbatim, and sends their 8-bit codes to the display verbatim. Thus, unibyte Emacs on MS-DOS supports the current codepage, whatever it may be, but cannot even represent any other characters. @vindex dos-codepage For multibyte operation on MS-DOS, Emacs needs to know which characters the chosen DOS codepage can display. So it queries the system shortly after startup to get the chosen codepage number, and stores the number in the variable @code{dos-codepage}. Some systems return the default value 437 for the current codepage, even though the actual codepage is different. (This typically happens when you use the codepage built into the display hardware.) You can specify a different codepage for Emacs to use by setting the variable @code{dos-codepage} in your init file. @cindex language environment, automatic selection on @r{MS-DOS} Multibyte Emacs supports only certain DOS codepages: those which can display Far-Eastern scripts, like the Japanese codepage 932, and those that encode a single ISO 8859 character set. The Far-Eastern codepages can directly display one of the MULE character sets for these countries, so Emacs simply sets up to use the appropriate terminal coding system that is supported by the codepage. The special features described in the rest of this section mostly pertain to codepages that encode ISO 8859 character sets. For the codepages which correspond to one of the ISO character sets, Emacs knows the character set name based on the codepage number. Emacs automatically creates a coding system to support reading and writing files that use the current codepage, and uses this coding system by default. The name of this coding system is @code{cp@var{nnn}}, where @var{nnn} is the codepage number.@footnote{The standard Emacs coding systems for ISO 8859 are not quite right for the purpose, because typically the DOS codepage does not match the standard ISO character codes. For example, the letter @samp{@,{c}} (@samp{c} with cedilla) has code 231 in the standard Latin-1 character set, but the corresponding DOS codepage 850 uses code 135 for this glyph.} @cindex mode line @r{(MS-DOS)} All the @code{cp@var{nnn}} coding systems use the letter @samp{D} (for ``DOS'') as their mode-line mnemonic. Since both the terminal coding system and the default coding system for file I/O are set to the proper @code{cp@var{nnn}} coding system at startup, it is normal for the mode line on MS-DOS to begin with @samp{-DD\-}. @iftex @xref{Mode Line,,,emacs, the Emacs Manual}. @end iftex @ifnottex @xref{Mode Line}. @end ifnottex Far-Eastern DOS terminals do not use the @code{cp@var{nnn}} coding systems, and thus their initial mode line looks like the Emacs default. Since the codepage number also indicates which script you are using, Emacs automatically runs @code{set-language-environment} to select the language environment for that script @iftex (@pxref{Language Environments,,,emacs, the Emacs Manual}). @end iftex @ifnottex (@pxref{Language Environments}). @end ifnottex If a buffer contains a character belonging to some other ISO 8859 character set, not the one that the chosen DOS codepage supports, Emacs displays it using a sequence of @acronym{ASCII} characters. For example, if the current codepage doesn't have a glyph for the letter @samp{@`o} (small @samp{o} with a grave accent), it is displayed as @samp{@{`o@}}, where the braces serve as a visual indication that this is a single character. (This may look awkward for some non-Latin characters, such as those from Greek or Hebrew alphabets, but it is still readable by a person who knows the language.) Even though the character may occupy several columns on the screen, it is really still just a single character, and all Emacs commands treat it as one. @cindex IBM graphics characters (MS-DOS) @cindex box-drawing characters (MS-DOS) @cindex line-drawing characters (MS-DOS) Not all characters in DOS codepages correspond to ISO 8859 characters---some are used for other purposes, such as box-drawing characters and other graphics. Emacs maps these characters to two special character sets called @code{eight-bit-control} and @code{eight-bit-graphic}, and displays them as their IBM glyphs. However, you should be aware that other systems might display these characters differently, so you should avoid them in text that might be copied to a different operating system, or even to another DOS machine that uses a different codepage. @vindex dos-unsupported-character-glyph Emacs supports many other characters sets aside from ISO 8859, but it cannot display them on MS-DOS. So if one of these multibyte characters appears in a buffer, Emacs on MS-DOS displays them as specified by the @code{dos-unsupported-character-glyph} variable; by default, this glyph is an empty triangle. Use the @kbd{C-u C-x =} command to display the actual code and character set of such characters. @iftex @xref{Position Info,,,emacs, the Emacs Manual}. @end iftex @ifnottex @xref{Position Info}. @end ifnottex @findex codepage-setup By default, Emacs defines a coding system to support the current codepage. To define a coding system for some other codepage (e.g., to visit a file written on a DOS machine in another country), use the @kbd{M-x codepage-setup} command. It prompts for the 3-digit code of the codepage, with completion, then creates the coding system for the specified codepage. You can then use the new coding system to read and write files, but you must specify it explicitly for the file command when you want to use it @iftex (@pxref{Text Coding,,,emacs, the Emacs Manual}). @end iftex @ifnottex (@pxref{Text Coding}). @end ifnottex These coding systems are also useful for visiting a file encoded using a DOS codepage, using Emacs running on some other operating system. @cindex MS-Windows codepages MS-Windows provides its own codepages, which are different from the DOS codepages for the same locale. For example, DOS codepage 850 supports the same character set as Windows codepage 1252; DOS codepage 855 supports the same character set as Windows codepage 1251, etc. The MS-Windows version of Emacs uses the current codepage for display when invoked with the @samp{-nw} option. Support for codepages in the Windows port of Emacs is part of the @file{code-pages.el} package. @node MS-DOS Processes @subsection Subprocesses on MS-DOS @cindex compilation under MS-DOS @cindex inferior processes under MS-DOS @findex compile @r{(MS-DOS)} @findex grep @r{(MS-DOS)} Because MS-DOS is a single-process ``operating system,'' asynchronous subprocesses are not available. In particular, Shell mode and its variants do not work. Most Emacs features that use asynchronous subprocesses also don't work on MS-DOS, including Shell mode and GUD. When in doubt, try and see; commands that don't work output an error message saying that asynchronous processes aren't supported. Compilation under Emacs with @kbd{M-x compile}, searching files with @kbd{M-x grep} and displaying differences between files with @kbd{M-x diff} do work, by running the inferior processes synchronously. This means you cannot do any more editing until the inferior process finishes. Spell checking also works, by means of special support for synchronous invocation of the @code{ispell} program. This is slower than the asynchronous invocation on other platforms Instead of the Shell mode, which doesn't work on MS-DOS, you can use the @kbd{M-x eshell} command. This invokes the Eshell package that implements a Posix-like shell entirely in Emacs Lisp. By contrast, Emacs compiled as a native Windows application @strong{does} support asynchronous subprocesses. @iftex @xref{Windows Processes,,,emacs, the Emacs Manual}. @end iftex @ifnottex @xref{Windows Processes}. @end ifnottex @cindex printing under MS-DOS Printing commands, such as @code{lpr-buffer} @iftex (@pxref{Printing,,,emacs, the Emacs Manual}) and @code{ps-print-buffer} (@pxref{PostScript,,,emacs, the Emacs Manual}), work in MS-DOS by sending the output to one of the printer ports. @xref{MS-DOS Printing,,,emacs, the Emacs Manual}. @end iftex @ifnottex (@pxref{Printing}) and @code{ps-print-buffer} (@pxref{PostScript}), work in MS-DOS by sending the output to one of the printer ports. @xref{MS-DOS Printing}. @end ifnottex When you run a subprocess synchronously on MS-DOS, make sure the program terminates and does not try to read keyboard input. If the program does not terminate on its own, you will be unable to terminate it, because MS-DOS provides no general way to terminate a process. Pressing @kbd{C-c} or @kbd{C-@key{BREAK}} might sometimes help in these cases. Accessing files on other machines is not supported on MS-DOS. Other network-oriented commands such as sending mail, Web browsing, remote login, etc., don't work either, unless network access is built into MS-DOS with some network redirector. @cindex directory listing on MS-DOS @vindex dired-listing-switches @r{(MS-DOS)} Dired on MS-DOS uses the @code{ls-lisp} package where other platforms use the system @code{ls} command. Therefore, Dired on MS-DOS supports only some of the possible options you can mention in the @code{dired-listing-switches} variable. The options that work are @samp{-A}, @samp{-a}, @samp{-c}, @samp{-i}, @samp{-r}, @samp{-S}, @samp{-s}, @samp{-t}, and @samp{-u}. @ignore arch-tag: 868d50ff-07f8-4a13-a807-dab6f1cdb431 @end ignore