view etc/TUTORIAL.eo @ 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.

Lernilo pri Emacs.  Vidu finon por kondiĉoj pri kopii.
Mallonga lernilo pri Emakso (Emacs). -- La uzokondiĉojn vd ĉe la fino.

Emaksaj ordonoj ĝenerale uzas aŭ la STIR-klavon (ofte markitan "Ctrl"
aŭ "CTL"), aŭ la META-klavon (ofte markitan "EDIT" aŭ "Alt").  Prefere
ol plene skribi tion ĉiufoje, ni uzos la sekvajn mallongigojn:

 C-<signo> signifas "premante la STIR-klavon tajpu la signon <signo>".
           Do, C-f estus: premtenu la STIR-klavon kaj tajpu f.

 M-<signo> signifas "premante la META-klavon (aŭ EDIT- aŭ Alt-klavon)
	   tajpu <signo>n.  Se vi havas nek META- nek EDIT- nek
	   Alt-klavon, anstataŭe premu kaj malpremu la Esc-klavon kaj
	   poste tajpu <signo>n.  Ni skribas <ESC> por la Esc-klavo.

GRAVA NOTO: por fini la Emaksan seancon, tajpu C-x C-c.  (Du signoj.)
En ĉi tiu lernilo, la signoj ">>" ĉe la maldekstra marĝeno rekomendas
al vi tuj provi uzi ordonon.  Ekzemple:
<<Blank lines inserted here by startup of help-with-tutorial>>
[Mezo de paĝo malplenas pro instruaj kialoj.  La teksto pluas sube.]
>> Nun tajpu C-v (Vidu sekvantan ekranplenon) por vidigi la sekvan
   ekranplenon.  (Procedu: tenante premita la STIR-klavon tajpu v).
   De nun, ripetu ĉi tion ĉiun fojon kiam vi finlegos la ekranon.

Notu ke estas dulinia komunaĵo inter la tujsekvaj ekranplenoj; tio
donas kontinuecon por faciligi la legadon.

Antaŭ ĉio vi bezonas scii kiel moviĝi de loko al loko en la teksto.
Vi jam povas moviĝi je unu ekrano antaŭen per C-v.  Por moviĝi
malantaŭen je unu ekrano, tajpu M-v (premu la META-klavon kaj tajpu v,
aŭ tajpu <ESC>c se vi ne havas META-, EDIT- aŭ Alt-klavon).

>> Provu tajpi M-v kaj sekve C-v kelkfoje.


* RESUMO
--------

La sekvaj ordonoj servas por foliumi ekranplenojn:

	C-v	Moviĝu antaŭen je unu ekranpleno
	M-v	Moviĝu malantaŭen je unu ekranpleno
	C-l     Viŝu la ekranon kaj reeligu la tutan tekston, aranĝante
		ĝin ĉirkaŭ la kursoro lokita centre de la ekrano.
		(Tiu estas C-L, la stira lo; ne C-1, la stira unu.)

>> Trovu la kursoron, kaj notu ĝian kuntekston.  Tajpu C-l.  Retrovu
   la kursoron kaj notu ke ĝi restas en la sama kunteksto.


* BAZAJ RIMEDOJ POR REGI KURSORON
---------------------------------

Foliumi per ekranplenoj estas utila afero, sed kiel oni moviĝu al
preciza loko en la teksto sur la ekrano?

Estas kelkaj metodoj por fari tion.  Oni povas uzi la sagoklavojn, sed
pli produktive estas teni la manojn en la normala pozicio kaj uzi la
ordonojn C-p, C-b, C-f, kaj C-n.  Ĉiu de tiuj ordonoj movas la
kursoron je unu vertikalo aŭ horizontalo en la koncerna direkto sur la
ekrano.  Ĉi tiu tabelo montras tiujn kvar ordonojn kaj kien ili movas
la kursoron:

			   Al la antaŭa linio, C-p
			   (angle: Previous line)
				   :
				   :
      Antaŭen, C-b .... Nuna loko de la kursoro .... Sekven, C-f
   (ang. Backward)		   :		     (ang. Forward)
				   :
			Al la sekva linio, C-n
			  (angle: Next line)

>> Movu la kursoron al la centra linio de la diagramo per C-n aŭ C-p.
   Tajpu C-l por vidi la tutan diagramon vertikale centrigita sur la
   ekrano.

La literoj estas elektitaj laŭ la koncernaj anglaj vortoj: P el
"previous", N el "next", B el "backward" kaj F el "forward".  Tiuj
estas la bazaj ordonoj por movi la kursoron, kaj vi uzos ilin ĉiam, do
utilas al vi lerni ilin nune.

>> Uzu C-n kelkfoje por mallevi la kursoron al ĉi tiu linio.

>> Uzu C-f por avanci en la linion kaj sekve C-p por movi supren.
   Atentu kion C-p faras kiam la kursoro estas meze de la linio.

Ĉiu teksta linio finiĝas per novlinia signo, kiu disigas ĝin disde la
sekva linio.  La lasta linio en via dosiero devus havi novlinion ĉe la
fino (sed Emacs ne postulas ĝin).

>> Provu uzi C-b ĉe linikomenco.  Ĝi devas movi al la fino de la
   antaŭa linio.  Tio okazas ĉar ĝi movas reen trans la novlinian
   signon.

C-f povas movi trans novlinion analogie kiel C-b

>> Uzu C-b por vidi kie estas la kursoro.
   Poste uzu C-f kelkfoje por reveni ĉe la linifinon.
   Poste faru unu C-f pli por transiri en la sekvantan linion.

Kiam vi pasas trans la supron aŭ malsupron de la ekrano, la teksto
transranda ŝoviĝas sur la ekranon.  Tio estas nomata "rulumado".  Ĝi
ebligas movi la kursoron al specifita loko en la teksto sen perdi ĝin
(la kursoron) de sur la ekrano.

>> Provu uzi C-n por movi la kursoron de sur la malsupro de la ekrano,
   kaj vidu kio okazas.

Se movado per signoj estas tro malrapida, moviĝu per vortoj.  M-f
(Meta-f) movas je unu vorto posten kaj M-b movas je unu vorto reen.

>> Tajpu kelkfoje M-f kaj M-b.

Kiam vi estas meze de vorto, M-f movas al la fino de la vorto.  Kiam
vi estas en intervorta spaco, M-f movas al la fino de la sekva vorto.
M-b faras analogie en la mala direkto.

>> Tajpu M-f kaj M-b kelkfoje, intermiksante kun C-f kaj C-b, por vidi
   la efikon de M-f kaj M-b el diversaj lokoj ene kaj inter vortoj.

Rimarku la analogion inter C-f kaj C-b unuflanke, kaj M-f kaj M-b
aliflanke.  Tre ofte Meta-signoj servas por funkcioj rilataj al unuoj
difinitaj lingve (vortoj, frazoj, alineoj), dum la stiraj C-signoj
funkcias sur elementaj unuoj sendependaj de la enhavo (signopozicioj,
linioj, ktp.).

Tiu analogio validas ankaŭ por linioj kaj frazoj: C-a kaj C-e movas al
la komenco aŭ fino de linio, kaj M-a kaj M-e movas al la komenco aŭ
fino de frazo.

>> Provu kelkajn C-a, poste kelkajn C-e.
   Provu kelkajn M-a, poste kelkajn M-e.

Observu kiel ripetaj C-a faras nenion pli ol unufoje, dum ripetaj M-a
plu movas je unu frazo pluen.  Kvankam la analogio ne estas plena, ĉiu
ordono kondutas nature.

La loko de la kursoro en la teksto estas nomata "punkto" (angle
"point").  Alidire, la kursoro montras sur la ekrano kie "punkto"
estas en la teksto.

Jen resumo de simplaj ordono por movi la kursoron, inklude la ordonojn
por moviĝi per vortoj kaj frazoj:

	C-f	Moviĝu sekven je unu signopozicio
	C-b	Moviĝu reen je unu signopozicio

	M-f	Moviĝu sekven je unu vorto
	M-b	Moviĝu antaŭen je unu vorto

	C-n	Moviĝu en la malsuran linion
	C-p	Moviĝu en la suran linion

	C-a	Moviĝu al la linikomenco
	C-e	Moviĝu al la linifino

	M-a	Moviĝu al la komenco de la frazo
	M-e	Moviĝu al la fino de la frazo

>> Provu ĉiujn ĉi ordonojn, nun po kelkfoje por praktiki.  Ili estas
   la plej ofte uzataj ordonoj.

Du aliaj kursormovaj ordonoj estas M-< (Meta Malpli-ol), kiu movas al
la komenco de la tuta teksto, kaj M-> (Meta Pli-ol), kiu movas al la
fino de la tuta teksto.

Ĉe la plejmulto de terminaloj, la "<" estas super la komo, do vi devas
uzi la majuskligan klavon por tajpi ĝin.  Ĉe tiuj terminaloj vi ankaŭ
devas uzi la majuskligan klavon por tajpi M-<; sen la majuskliga klavo
rezultus "M-," (Meta-komo).

>> Provu tajpi M-< nune, por moviĝi al la komenco de la lernilo.
   Poste uzu C-v multfoje por reveni ĉi tien.

>> Provu tajpi M-> nune, por moviĝi al la fino de la lernilo.
   Poste uzu M-v multfoje por reveni ĉi tien.

Vi ankaŭ povas movi la kursoron per la sagoklavoj, se via terminalo
havas ilin.  Ni tamen rekomendas ke vi lernu C-b, C-f, C-n kaj C-p pro
tri kialoj.  Unue, ili funkcias ĉe ĉia terminalo.  Due, kiam vi
kutimiĝos al Emakso, vi trovos ke tajpi tiujn stirsignojn estas pli
rapida ol tajpi la sagoklavojn (ĉar vi ne devas formovi viajn manojn
de la normala tajpada pozicio).  Trie, kiam vi kutimiĝos uzi tiujn
stirajn ordonojn, vi facile lernos uzi ankaŭ aliajn kursormovajn
ordonojn.

La plejparto da Emaksaj ordonoj akceptas nombran argumenton; por la
plejparto da ordonoj, ĝi funkcias kiel ripetilo.  Por indiki al ordono
la nombron de ripetoj, tajpu C-u kaj sekve la ciferojn antaŭ ol tajpi
la ordonon.  Se vi havas META-klavon (aŭ EDIT-, aŭ Alt-klavon), eblas
ankaŭ alia metodo por doni nombran argumenton: tajpu la ciferojn
premtenante la META-klavon.  Ni rekomendas lerni la metodon de C-u ĉar
ĝi funkcias ĉe ĉia terminalo.  La nombra argumento ankaŭ estas nomata
"prefiksa argumento", ĉar la argumenton oni tajpas antaŭ la koncerna
ordono.

Ekzemple, C-u 8 C-f movas vin al la oka signo sekvanta.

>> Uzu C-n aŭ C-p kun nombra argumento por movi la kursoron en apudan
   linion per sola ordono.

La plejparto da ordonoj uzas la nombran argumenton kiel ripetilon, sed
iuj ordonoj ĝin uzas alicele.  Kelkaj ordonoj (tamen neniu el la
lernitaj) uzas ĝin kiel indikilon -- la ekzisto de prefiksa argumento,
sendepende de ĝia valoro, igas la ordonon agi alimaniere.

C-v kaj M-v estas alispeca escepto.  Kiam vi donas al ili argumenton,
ili rulumas la ekranon supren aŭ suben je tiom da linioj, anstataŭ je
ekranplenoj.  Ekzemple, C-u 8 C-v rulumas la ekranon je 8 linioj.

>> Tajpu C-u 8 C-v nun.

Ĉi tio devis rulumi la ekranon je 8 linioj supren.  Se vi deziras
retrorulumi ĝin suben, vi povas doni argumenton al M-v.

Se vi uzas Emakson sub grafika fenestrosistemo, ekz-e X11 aŭ
MS-Windows, ĝi devas havi altan ortograman regionon nomatan rulumskalo
ĉe la (mal)dekstra flanko de la Emaksa fenestro.  Vi povas rulumi la
tekston klakante per la muso en la rulumskalo.

>> Provu premi la mezan butonon (de la muso) ĉe la supro de la
   emfazata regiono interne de la rulumskalo.  Tio devus rulumi la
   tekston ĝis pozicio determinita per tio, kiom alte aŭ malalte vi
   alklakis.

>> Provu movi la muson supren kaj suben, tenante premita la mezan
   musbutonon.  Vi vidos ke la teksto rulumas supren kaj suben laŭ
   tio, kiel vi movas la muson.


* SE EMAKSO SVENIS
------------------

Se Emakso ĉesis respondi al viaj ordonoj, vi povas sendanĝere ĝin
malbloki tajpante C-g.  Vi povas uzi C-g por haltigi ordonon kiu
plenumiĝas tro longe.

Vi ankaŭ povas uzi C-g por forigi nombran argumenton aŭ la komencon de
ordono kiun vi ne deziras fini.

>> Tajpu C-u 100 por fari nombran argumenton 100, sekve tajpu C-g.
   Nun tajpu C-f.  Ĝi devas movi je nur unu signo, ĉar vi forigis la
   argumenton per C-g.

Se vi erare tajpis <ESC> (la eskapklavon), vi povas vin malembarasi de
ĝi per C-g.


* MALŜALTITAJ ORDONOJ
---------------------

Iuj Emaksaj ordonoj estas malŝaltitaj por ke komencantoj ne uzu ilin
akcidente.

Se vi tajpas iun el la malŝaltitaj ordonoj, Emakso eligas mesaĝon
indikantan la tajpitan ordonon, kaj demandas ĉu vere vi volas uzi ĝin.

Se vi intencas uzi la ordonon, tajpu spaceton responde al la demando.
Normale, se vi ne deziras plenumi la malŝaltitan ordonon, respondu per
"n".

>> Tajpu C-x C-l (kiu estas malŝaltita ordono), kaj tajpu "n" responde
   al la demando.


* FENESTROJ
-----------

En Emakso vi povas havi plurajn fenestrojn montrantajn sian propran
tekston.  Ni klarigos poste kiel uzi plurajn fenestrojn.  Sed nun ni
klarigu kiel forigi nebezonatajn fenestrojn kaj reveni al la simpla
unufenestra redaktado.  Tio estas facila:

	C-x 1	Unu fenestro (t.e., forigu ĉiujn aliajn fenestrojn)

Tio estas STIR-x kaj poste la cifero 1.  "C-x 1" pligrandigas la
fenestron enhavantan la kursoron, tiel ke ĝi okupu la tutan ekranon.
Ĝi malaperigas ĉiujn aliajn fenestrojn.

>> Movu la kursoron en ĉi tiun linion kaj tajpu C-u 0 C-l.
>> Tajpu C-h k C-f.
   Vidu kiel ĉi tiu fenestro malkreskas, dum nova fenestro aperas por
   montri instrukcion pri la C-f ordono.

>> Tajpu C-x 1 kaj vidu la instrukcian fenestron malaperi.

Tiu ordono malsimilas la aliajn ordonojn kiujn vi lernis antaŭe ĉar ĝi
konsistas el du signoj.  Ĝin komencas la signo STIR-x.  Ekzistas tuta
serio da ordonoj kiuj komenciĝas per STIR-x; multaj el ili koncernas
fenestrojn, dosierojn, bufrojn, kaj rilatajn aferojn.  Tiuj ordonoj
estas du, tri aŭ kvar signojn longaj.


* ENŜOVO KAJ FORVIŜO
--------------------

Se vi deziras enŝovi tekston, simple ĝin tajpu.  Signojn kiujn oni
povas vidi, ekzemple A, 7, *, ktp, Emakso traktas kiel tekston kaj
enmetas tuj.  Tajpu <Return> (la enigan klavon) por enigi linifinilon.

Por forviŝi la ĵus tajpitan signon tajpu <Retroviŝu>.  <Retroviŝu>
estas tiu klavo de la klavaro, kiun oni ankaŭ ekster Emakso normale
uzas por forigi la ĵus tajpitan signon.  Kutime ĝi estas granda klavo
unu aŭ du vicojn super Return-klavo, kaj eble estas markita per
"Delete", "Del" aŭ "Backspace".

Se tiu klavo estas markita per "Backspace" (retropaŝo), tiam ĝuste ĝin
oni uzu por <Retroviŝu>.  Se krome estas alia klavo, markita <Delete>,
ĝi ne estas <Retroviŝu>.

Ĝenerale, <Retroviŝu> estas tiu klavo kiu forviŝas la signon tuj antaŭ
la nuna kursorloko.

>> Faru ĉi tion nun -- tajpu kelkajn signojn, poste forviŝu ilin
   tajpante kelkajn <Retroviŝu>.  Ne timu difekti ĉi tiun dosieron; vi
   ne ŝanĝos la originalan lernilon.  Ĉi tio estas nur ties labora
   kopio por vi.

Kiam linio da teksto iĝas pli longa ol la ekrana linio, la teksta
linio transiras sur la sekvan ekranan linion.  Retroklino ("\") -- aŭ,
en grafika fenestrosistemo, kurba sageto -- en la dekstra marĝeno
indikas tian transiron.

>> Enigu tekston ĝis ĝi atingos la dekstran marĝenon, kaj plu enigu.
   Vi vidos transiron en la sekvan linion.

>> Ripete <Retroviŝu> por remallongigi la tekstan linion ĝis la longo
   de unu ekrana linio denove.  La transiro malaperas.

Vi povas forviŝi linifinan signon tiel same kiel iun ajn signon.
Forviŝo de linifinilo inter du linioj kunigas ilin en unu linion.  Se
la rezulta kunigita linio estas pli longa ol la ekrana larĝo, ĝi
aperos kun transiro.

>> Movu la kursoron al la komenco de linio kaj tajpu <Retroviŝu>.  La
   linio kuniĝos kun la ĵusa linio.

>> Tajpu <Return> por reenigi la linifinilon kiun vi ĵus forviŝis.

Memoru ke vi povas doni ripetilon al plejparto da Emaksaj ordonoj; tio
koncernas ankaŭ tekstajn signojn.  Ripetilo ĉe teksta signo enigas ĝin
plurfoje.

>> Provu tion nun -- tajpu "C-u 8 *" por enigi "********".

Vi lernis la plej fundamentan metodon por tajpi en Emakso kaj por
korekti erarojn.  Vi povas forviŝi per vortoj aŭ per linioj.  Jen
resumo de forviŝaj ordonoj:

	<Retroviŝu>     forviŝu la signon ĵus antaŭ la kursoro
	C-d		forviŝu la signon tuj post la kursoro

	M-<Retroviŝu>   forĵetu la vorton ĵus antaŭ la kursoro
	M-d		forĵetu la vorton tuj post la kursoro

	C-k		forĵetu de la kursorloko ĝis la linifino
	M-k		forĵetu de la kursorloko ĝis la frazfino

Rimarku ke <Retroviŝu> kaj C-d rilate al M-<Retroviŝu> kaj M-d etendas
la analogion komencitan de C-f kaj M-f (nu, <Retroviŝu> ne vere estas
stirsigno, sed ni ne estu tro pedantaj).  C-k kaj M-k iom similas al
C-e kaj M-e, sed rilate al linioj anstataŭ frazoj.

Vi ankaŭ povas forĵeti iun ajn parton de la bufro per unu senvaria
metodo.  Moviĝu al unu ekstremaĵo de tiu parto, kaj tajpu "C-@" (aŭ
"C-SPC", "SPC" simbolas spaceton).  Moviĝu al la alia ekstremaĵo, kaj
tajpu C-w.  Tio forĵetas la tutan tekston inter la du lokoj.

>> Movu la kursoron al la V ĉe la komenco de la antaŭa alineo.
>> Tajpu C-SPC.  Emakso devas montri mesaĝon: "Mark set" ("Markite")
   ĉe la fundo de la ekrano.
>> Movu la kursoron al la o en "ekstremaĵo", en la dua linio de la
   alineo.
>> Tajpu C-w.  Tio forĵetos la tekston komenciĝantan ĉe la V, kaj
   finiĝantan ĵus antaŭ la o.

La diferenco inter "forĴETI" kaj "forVIŜI" ion konsistas en tio, ke vi
povas re-enŝovi "forĵetitajn" aĵojn, sed ne "forviŝitajn" aĵojn.
Re-enŝovo de forĵetita teksto nomiĝas "enĵeto" (angle "yanking").
Ĝenerale, la ordonoj por forigi multe da teksto ĝin "forĵetas" (do,
ili ankaŭ ebligas ĝin "enĵeti"); male, la ordonoj por forviŝi nur unu
signon, aŭ nur blankajn liniojn kaj spacetojn, ne konservas la
forigitan tekston (kaj oni ne povas ĝin enĵeti).

>> Movu la kursoron al la komenco de nemalplena linio.  Poste tajpu
   C-k por forĵeti la tekston de tiu linio.
>> Tajpu C-k duafoje.  Vi vidos ke ĝi forĵetas la linifinilon
   sekvantan tiun linion.

Rimarku ke unuopa C-k forĵetas la enhavon de la linio, kaj dua C-k
forĵetas la linion mem kaj igas la postajn liniojn ŝoviĝi supren.  C-k
traktas nombran argumenton speciale: ĝi forĵetas tiom da linioj KAJ
ilian enhavaĵon.  Ĉi tio ne estas simpla ripetado.  C-u 2 C-k forĵetas
du liniojn kaj iliajn linifinojn; tajpi C-k dufoje ne farus tion.

Reenigi forĵetitan tekston nomiĝas "enĵetado".  Vi povas enĵeti la
forĵetitan tekston aŭ en la saman lokon de kie ĝi estis forĵetita, aŭ
en alian lokon de la redaktata teksto, aŭ eĉ en alian dosieron.  Vi
povas enĵeti la tekston kelkfoje por fari plurajn kopiojn de ĝi.

Por repreni la laste forĵetitan tekston kaj enigi ĝin tien kie la
kursoro nune estas, tajpu "C-y" (de la angla vorto "yank").

>> Provu ĝin: tajpu C-y por enĵeti la tekston.

Atentu ke se vi tujsekve faras plurajn C-k, ĉiuj forĵetataĵoj
konserviĝas kune, por ke oni povu enĵeti ĉiujn ĉi liniojn per unu C-y.

>> Faru ĉi tion nun, tajpu C-k kelkfoje.

Nun, por repreni tiun forĵetitan tekston:

>> Tajpu C-y.  Poste movu la kursoron je kelkaj linioj suben kaj tajpu
   C-y denove.  Nun vi scias kiel kopii iom da teksto.

Kion fari se vi, havante iom da teksto enĵetota, forĵetas ion alian?
C-y enĵetus la pli ĵusan forĵetaĵon.  Sed la antaŭa teksto ne estas
perdita.  Vi povas re-enĵeti ĝin per la ordono M-y.  Farinte C-y por
enĵeti la plej ĵusan forĵetaĵon, tajpu M-y por anstataŭigi la
enĵetitan tekston per pli frua forĵetaĵo.  Tajpadu M-y denove, kaj unu
post la alia enĵetiĝos pli fruaj forĵetaĵoj.  Trovinte la serĉatan
pecon, vi ne bezonas fari ion por konservi ĝin.  Simple daŭrigu vian
redaktadon, kaj lasu la enĵetitan tekston tie kie ĝi estas.

Se vi uzos M-y sufiĉe da fojoj, vi revenos al la komenca loko (la plej
ĵusa forĵetaĵo).

>> Forĵetu linion, moviĝu ien, forĵetu alian linion.
   Poste uzu C-y por enĵeti reen la duan forĵetitan linion.
   Poste uzu M-y kaj la unua forĵetita linio anstataŭigos ĝin.
   Uzu M-y plue kaj rigardu kion vi akiras.  Daŭrigu ĝis la reapero de
   la dua forĵetita linio, kaj poste de kelkaj pli.  Se vi deziras, vi
   povas doni al M-y pozitivajn kaj negativajn argumentojn.


* MALFARADO
-----------

Se vi ŝanĝis la tekston, kaj sekve decidas ke tio estis eraro, vi
povas malfari la ŝanĝon per la "malfaru"-ordono, C-x u (de la angla
"undo").

Normale, C-x u malfaras la ŝanĝojn faritajn per unu ordono; se vi
tujsekve ripetas la ordonon C-x u kelkfoje, ĉiu ripeto malfaras unu
plian ordonon.

Sed estas du esceptoj: ordonoj kiuj ne ŝanĝas la tekston ne estas
atentataj (tiuj inkludas kursormovajn kaj rulumadajn ordonojn), kaj
memenigaj signoj kutime ariĝas en grupojn po ĝis 20.  (Tio malpliigas
la tajpadojn de C-x u necesajn por malfari tekstenigon.)

>> Forĵetu ĉi-linion per C-k, sekve tajpu C-x u kaj ĝi devas reaperi.

C-_ estas alternativa malfara ordono; ĝi funkcias same kiel C-x u, sed
ĝi estas pli facila por plurfoja tajpado sinsekva.  La malavantaĝo de
C-_ estas ke iuj klavaroj malhavas evidentan metodon por tajpi ĝin.
Tial ni provizas ankaŭ C-x u.  Ĉe iu klavaroj vi povas ricevi C-_
tajpante / dum vi premtenas STIR-klavon.

Nombra argumento ĉe C-_ aŭ C-x u agas kiel ripetilo.

Vi povas malfari forviŝon de teksto egale bone kiel vi povas malfari
forĵeton de teksto.  La diferenco inter forviŝo kaj forĵeto koncernas
la eblon enĵeti per C-y; ĝi ne ekzistas por malfaro.


*  DOSIEROJ
-----------

Por persistigi la redaktatan tekston, necesas meti ĝin en dosieron.
Alie, ĝi pereos kiam via Emaksa procezo finiĝos.  Por meti vian
tekston en dosieron, necesas "trovi" la dosieron antaŭ ol enigi la
tekston.  (Tio ankaŭ estas nomata "viziti" la dosieron; angle "find,
visit a file".)

Trovi dosieron signifas ke vi igas la enhavon de la dosiero atingebla
per Emakso.  Plurrilate, ĝi estas kvazaŭ vi redaktus la dosieron mem.
Tamen, la ŝanĝoj kiujn vi faras per Emakso ne persistiĝas ĝis kiam vi
"konservos" (angle "save") la dosieron.  Vi povas konservi la dosieron
por ne lasi duonŝanĝitan dosieron ĉe la sistemo kiam vi ne deziras
tion.  Eĉ kiam vi konservas, Emakso lasas la originalan dosieron sub
ŝanĝita nomo por la eventualo ke vi poste decidos ke viaj ŝanĝoj estis
eraraj.

Se vi rigardos apud la fundon de la ekrano vi vidos linion kiun
komencas kaj finas strekoj; komence "--:-- TUTORIAL.eo" aŭ io simila.
Tiu parto de la ekrano normale montras la nomon de la vizitata
dosiero.  Ĝuste nun, vi vizitas dosieron nomatan "TUTORIAL.eo" kiu
estas via propra kopio de la Emaksa lernilo.  Kiam vi trovas dosieron
per Emakso, la nomo de tiu dosiero aperas ĉe tiu sama loko.

Unu apartaĵo de la dosiertrova ordono estas, ke vi devas indiki kiun
dosiernomon vi deziras.  Ni diras ke la ordono "legas argumenton de la
terminalo" (ĉi-okaze la argumento estas la dosiernomo).  Post kiam vi
tajpis la ordonon

	C-x C-f   Trovu dosieron

Emakso petas ke vi tajpu la dosiernomon.  La dosiernomo kiun vi tajpas
aperas sur la plej malsupra linio de la ekrano.  Tiu linio estas
nomata "la bufreto" (angle "minibuffer") kiam ĝi estas uzata por tia
speco de enigado.  Vi povas uzi ordinarajn Emaksajn redaktajn ordonojn
por redakti la dosiernomon.

Dum vi enigas la dosiernomon (aŭ iun ajn bufretan enigon), vi povas
aboli la ordonon per C-g.

>> Tajpu C-x C-f, kaj sekve C-g.  Ĉi tio abolas la bufreton, kaj ankaŭ
   abolas la ordonon "C-x C-f" kiu uzis la bufreton.  Do vi ne trovis
   dosieron.

Fininte enigi la dosiernomon, tajpu <Return>.  Tiam eklaboros la
ordono C-x C-f, kaj trovos la dosieron kiun vi elektis.  La bufreto
malaperos kiam la C-x C-f ordono finiĝos.

Post eta tempo la enhavo de la dosiero aperas sur la ekrano, kaj vi
povas redakti la enhavon.  Kiam vi deziras persistigi viajn ŝanĝojn,
tajpu la ordonon

	C-x C-s   konServu (angle "save") la dosieron

Tio kopias la tekston el interne de Emakso en la dosieron.  Ĉe la unua
konservado, Emakso renomas la originalan dosieron per nova nomo por ke
ĝi ne perdiĝu.  La nova nomo estas farata per aldono de "~" al la fino
de la originala dosiernomo.

Fininte la konservadon, Emakso montras la nomon de la dosiero
skribita.  Konservu sufiĉe ofte, por ne perdi multe da laboro se la
sistemo paneos.

>> Tajpu C-x C-s, por konservi vian kopion de la lernilo.
   Emakso devas montri la mesaĝon "Wrote ...TUTORIAL.eo" (Skribis
   ...TUTORIAL.eo) ĉe la fundo de la ekrano.

Vi povas trovi ekzistantan dosieron, por vidigi aŭ redakti ĝin.  Vi
ankaŭ povas trovi dosieron kiu ankoraŭ ne ekzistas.  Ĉi tio estas la
maniero por krei dosieron per Emakso: trovu la dosieron, komence
malplenan, kaj sekve ekenigu la tekston por la dosiero.  Kiam vi petos
"konservi" la dosieron, Emakso vere kreos la dosieron kun la teksto
kiun vi enigis.  De tiam vi povos opinii ke vi redaktas jam
ekzistantan dosieron.


* BUFROJ
--------

Se vi trovas duan dosieron per C-x C-f, la unua dosiero restas interne
de Emakso.  Vi povas reiri al ĝi retrovante ĝin denove per C-x C-f.
Tio ebligas al vi meti plurajn dosierojn en Emakson.

>> Kreu dosieron nomatan "umo" tajpante "C-x C-f umo <Return>".
   Poste enigu iom da teksto, redaktu ĝin, kaj konservu "umo"n
   tajpante "C-x C-s".
   Fine, tajpu "C-x C-f TUTORIAL.eo <Return>" por reveni al la
   lernilo.

Emakso tenas la tekston de ĉiu dosiero en objekto nomata "bufro".
Trovo de dosiero kreas novan bufron interne de Emakso.  Por vidi
liston de la bufroj kiuj nune ekzistas en via Emakso-procezo, tajpu

	C-x C-b   Listigu bufrojn

>> Provu C-x C-b nun.

Vi vidas, ke ĉiu bufro havas nomon, kaj ke ĝi ankaŭ eble havas
dosiernomon por la dosiero kies enhavon ĝi tenas.  ĈIU teksto kiun vi
vidas en Emaksa fenestro estas ĉiam parto de iu bufro.

>> Tajpu C-x 1 por forigi la liston de bufroj.

Se vi havas plurajn bufrojn, je ĉiu momento nur nur unu el ili estas
"la kuranta": tiu, kiun vi redaktas.  Se vi volas redakti alian
bufron, vi bezonas "transiri" en ĝin.  Se la celata bufro respondas al
dosiero, vi povas transiri per vizito al ĝi: C-x C-f ...  Sed estas
pli facila metodo: uzi la ordonon "C-x b", donante al ĝi la nomon de
la celata bufro.

>> Tajpu "C-x b umo <Return>" por transiri en la bufron "umo",
   entenantan la tekston de la dosiero "umo".
   Poste tajpu "C-x b TUTORIAL.eo <Return>" por reveni en la lernilon.

Plej ofte, la bufronomo estas egala al la nomo de ĝia dosiero (sen la
dosiera parto).  Tamen, ne ĉiam tio estas vera.  La listo de bufroj
farita per "C-x C-b" ĉiam vidigas al vi la nomojn de ĉiuj bufroj.

ĈIU teksto kiun vi vidas en Emaksa fenestro estas ĉiam parto de iu
bufro.  Tamen iuj bufroj ne respondas al dosieroj.  Ekzemple, la bufro
nomata "*Buffer List*" (Listo de Bufroj) ne havas dosieron.  Ĝi estas
la bufro enhavanta la liston de bufroj faritaj per la ordono C-x C-b.
Ankaŭ la bufro "*Messages*" respondas al neniu dosiero; ĝi entenas la
mesaĝojn aperintajn en la funda linio dum la Emaksa seanco.

>> Tajpu "C-x b *Messages* <Return>" por vidigi la bufron de mesaĝoj.
   Poste tajpu "C-x b TUTORIAL.eo <Return>" por reveni en la lernilon.

Se vi ŝanĝas la tekston de unu dosiero, kaj sekve trovas alian
dosieron, ĉi tio ne konservas la unuan dosieron.  Ĝiaj ŝanĝoj restas
interne de Emakso, en la bufro de tiu dosiero.  La kreado aŭ redaktado
de la bufro de la dua dosiero ne efikas la bufron de la unua dosiero.
Ĉi tio estas utilega, sed ĝi ankaŭ signifas ke vi bezonas oportunan
metodon por konservi la bufron de la unua dosiero.  Estas ĝena devi
revenadi en ĝin per C-x C-f nur por konservi ĝin per C-x C-s.  Tial ni
havas

	C-x s     Konservu iom da bufroj.

C-x s demandas vin pri ĉiu ŝanĝita bufro kiun vi ne konservis.  Ĝi
demandas vin, pri ĉiu tia bufro, ĉu konservi la bufron.

>> Enigu linion da teksto, kaj sekve tajpu C-x s.
   Emakso devas demandi vin ĉu ĝi konservu la bufron "TUTORIAL.eo".
   Jesu tajpante "y" (de la angla "yes").


* ETENDI LA ORDONARON
---------------------

Ekzistas multege pli da Emaksaj ordonoj ol eblas meti sur ĉiuj el la
stiraj kaj meta-aj signoj.  Emakso solvas tiun problemon per la
X-ordonoj (de la angla eXtend, "etendo").  Estas du specoj da ili:

	C-x     Signa etendo.  Sekvata de unu signo.
	M-x	Nomhava ordona etendo.  Sekvata de plena nomo.

Ĉi tiuj estas la ordonoj ja utilaj, sed malpli oftaj ol la ordonoj
kiujn vi jam lernis.  Vi jam vidis du el ili: la dosierajn ordonojn
C-x C-f por "trovi" kaj C-x C-s por "konservi".  Alia ekzemplo estas
la ordono por fini Emaksan seancon -- la ordono C-x C-c.  (Ne timu
perdi faritajn ŝanĝojn; C-x C-c proponas konservi ĉiun ŝanĝitan
dosieron antaŭ ol ĉesigi Emakson.)

C-z estas la ordono por eliri Emakso *provizore* -- tiel ke vi povas
reveni en la saman Emaksan seancon poste.

Sur sistemoj kiuj permesas ĝin, C-z "provizore ĉesigas" Emakson; t.e.
ĝi revenas en la ŝelon sed ne detruas Emakson.  Je la plej komunaj
ŝeloj, vi povas reaktivigi Emakson per la ordono "fg" (de la angla
"foreground") aŭ per "%emacs".

Sur sistemoj kiuj ne permesas provizoran ĉesigon, C-z kreas sub-ŝelon
sub Emakso por doni al vi ŝancon lanĉi aliajn programojn kaj reiri al
Emakso poste; ĝi ne vere "eliras" el Emakso.  Ĉi-okaze, la ŝela ordono
"exit" (eliru) estas la kutima maniero reiri al Emakso de la sub-ŝelo.

La ordonon C-x C-c uzu por adiaŭi.  Ĝi estas ankaŭ la ordono uzenda
por eliri Emakson lanĉitan per retpoŝta programo aŭ alia simila
utilaĵo, ĉar tiuj eble ne scias kiel trakti provizoran ĉesigon de
Emakso.  Tamen, ordinare, se vi ne estas tuj adiaŭonta, preferindas
provizore ĉesigi Emakson per C-z anstataŭ eliri Emakson.

Ekzistas multe da ordonoj C-x.  Jen listo de tiuj kiujn vi jam konas:

	C-x C-f		Trovu dosieron.
	C-x C-s		Konservu dosieron.
	C-x C-b		Listigu bufrojn.
	C-x C-c		Ĉesigu Emakson.
	C-x 1		Forigu ĉiujn fenestrojn krom unu.
	C-x u		Malfaru.

Nomhavajn etenditajn ordonojn oni uzas eĉ malpli ofte, aŭ uzas ilin
nur en kelkaj reĝimoj.  Ekzemplo estas la ordono "replace-string"
(anstataŭigu-ĉenon), kiu anstataŭigas unu ĉenon je alia tutbufre.
Kiam vi tajpas M-x, Emakso demandas de vi ĉe la fundo de la ekrano la
nomon de la ordono; ĉi-okaze, "replace-string".  Simple tajpu
"repl s<TAB>" kaj Emakso kompletigos la nomon.  Finu la ordonnomon
per <Return>.

La ordono replace-string postulas du argumentojn -- la anstataŭigOTan
kaj la anstataŭigONTan ĉenojn.  Ĉiun argumenton finu per <Return>.

>> Movu la kursoron al la blanka linio du liniojn sub ĉi tiu.
   Poste tajpu "M-x repl s<Return>linio<Return>peco<Return>".

   Rimarku kiel tiu ĉi linio ŝanĝiĝis: vi anstataŭigis la vorton
   l-i-n-i-o per "peco" kie ajn ĝi aperis, de post la komenca loko de
   la kursoro.


* AŬTOMATA KONSERVADO
---------------------

Kiam vi faris ŝanĝojn en dosiero, sed ankoraŭ ne konservis ilin, ili
povus perdiĝi se via komputilo paneos.  Por protekti vin de tio,
Emakso periode "aŭtokonservas" ĉiujn dosierojn kiun vi redaktas.  La
nomo de aŭtokonservita dosiero havas la signon "#" komence kaj fine;
ekzemple, se via dosiero estas nomata "hello.c", ĝia aŭtokonservita
dosiero nomiĝos "#hello.c#".  Kiam vi konservos la dosieron
normalmaniere, Emakso malkreos ĝian aŭtokonservitan dosieron.

Por reakiri vian aŭtokonservitajn redaktaĵojn post paneo,
normalmaniere "trovu" la dosieron (per la nomo de la dosiero kiun vi
redaktis, ne per la nomo de la aŭtokonservita dosiero) kaj poste tajpu
"yes<Return>" por konfirmi ke vi volas uzi la aŭtomate konservitan
datumon.


* EĤA AREO
----------

Se vi tajpas plursignan ordonon malrapide, Emakso montras ĝin al vi ĉe
la fundo de la ekrano en areo nomata la "eĥa areo".  La eĥa areo
enhavas la plej malsupran linion de la ekrano.


* REĜIMLINIO
-------------

La linio tuj super la eĥa areo estas nomata la "reĝimlinio".  La
reĝimlinio montras ion similan al ĉi tio:

--:**  TUTORIAL.eo    63% L749    (Fundamental)-----------------------

Tiu linio donas al vi utilan informon pri la stato de Emakso kaj la
redaktata teksto.

Vi jam scias kion signifas la dosiernomo -- ĝi estas la dosiero kiun
vi trovis.  -NN%-- montras vian nunan lokon en la teksto; ĝi signifas
ke NN elcentoj de la teksto estas supren de la supro de la ekrano.  Se
la supro de la dosiero estas sur la ekrano, ĝi montras --Top--
anstataŭ -- 0%--.  Se la malsupro de la teksto estas sur la ekrano, ĝi
montras --Bot--.  Se vi rigardas tekston tiom malgrandan ke ĉiom da ĝi
aperas en la ekrano, la reĝimlinio montras --All--.

La L kun ciferoj indikas la pozicion alimaniere: ili indikas la
kurantan lininumeron de "punkto".

La steloj ĉe la komenco signifas ke vi ŝanĝis la tekston.  Antaŭ la
ŝanĝoj, kiam vi ekvizitas aŭ konservis dosieron, en tiu parto de la
reĝimlinio estas neniaj steloj, nur strekoj.

La enkrampa parto de la reĝimlinio montras al vi kiujn redaktadajn
reĝimojn vi uzas.  La defaŭlta reĝimo estas "Fundamental" (fundamenta)
kiun vi uzas nun.  Ĝi estas ekzemplo pri "ĉefreĝimo".

Emakso havas multajn diversajn reĝimojn.  Iuj el ili estas por redakti
diversajn lingvojn kajaŭ specojn de teksto, ekzemple Lisp-reĝimo,
Teksta-reĝimo, ktp.  Ĉiam unu kaj nur unu ĉefreĝimo estas aktiva, kaj
ĝia nomo ĉiam aperas en la reĝimlinio ĝuste kie "Fundamental" estas
nun.

Ĉiu ĉefreĝimo igas iujn ordonojn agi malsame.  Ekzemple, estas ordonoj
por krei komentojn en programo, kaj ĉar ĉiu programlingvo havas
malsaman ideon pri tio, kiel komento aspektu, ĉiu ĉefreĝimo devas
enigi komentojn malsame.  Ĉiu ĉefreĝimo estas la nomo de etenda
ordono, per kiu vi povas ŝalti tiun reĝimon.  Ekzemple,
"M-x fundamental-mode" estas ordono por ŝalti la Fundamentan reĝimon.

Se vi redaktos tekston (esperantan, anglan ktp), ekzemple ĉi tiun
dosieron, al vi eble konvenos Teksta-reĝimo.

>> Tajpu M-x text-mode<Return>.

Ne maltrankviliĝu, la Emaksaj ordonoj kiujn vi jam lernis malmulte
ŝanĝiĝas.  Sed vi povas observi ke M-f kaj M-b nun traktas apostrofojn
kial parton de vortoj.  Antaŭe, en Fundamenta reĝimo, M-f kaj M-b
traktis apostrofojn kiel vortajn disigilojn.

Ĉefreĝimoj kutime faras tiajn subtilajn ŝanĝojn: la plejmulto da
ordonoj faras "la saman taskon" en ĉiu ĉefreĝimo, sed ili funkcias
iomete malsame.

Por vidi dokumentaron pri via nuna ĉefreĝimo, tajpu C-h m.

>> Per kelkaj C-u C-v loku ĉi tiun linion ĉe la supro de la ekrano.
>> Tajpu C-h m, por vidi kiel la Teksta reĝimo diferencas disde la
   Fundamenta reĝimo.
>> Tajpu C-x 1 por forigi la dokumentaron for de la ekrano.

Ĉefreĝimojn oni nomas ĉefaj ĉar ekzistas ankaŭ "kromreĝimoj".
Kromreĝimoj ne estas alternativoj kontraŭ la ĉefreĝimoj, nur negravaj
modifoj al ili.  Ĉiun kromreĝimon oni povas ŝalti aŭ malŝalti,
sendepende de ĉiuj aliaj kromreĝimoj, kaj sendepende de la ĉefreĝimo.
Do vi povas uzi neniom da kromreĝimoj, aŭ unu kromreĝimon, aŭ ian ajn
kombinaĵon de kelkaj kromreĝimoj.

Unu utilega kromreĝimo, precipe por redakti homlingvan tekston
(esperantan, anglan ktp), estas la reĝimo de Aŭtomata Linifaldo (Auto
Fill mode).  Kiam ĝi estas ŝaltita, Emakso aŭtomate rompas la linion
inter vortoj ĉiufoje kiam la enigata tekstolinio iĝas tro larĝa.

Por ŝalti la reĝimon de Aŭtomata Linifaldo tajpu
"M-x auto fill mode<Return>".  Kiam la reĝimo estas ŝaltita, vi povas
malŝalti ĝin denove tajpante "M-x auto fill mode<Return>".  Se la
reĝimo estas malŝaltita, tiu ordono ŝaltas ĝin, kaj se ĝi estas
ŝaltita, tiu ordono malŝaltas ĝin.  Ni diras ke la ordono "transŝaltas
la reĝimon".

>> Tajpu "M-x auto file mode<Return>".  Poste enigi linion el "asdf ",
   ripete, ĝis vi vidos ĝin dividita en du liniojn.  Vi devas enigi
   spacetojn inter "asdf", ĉar la Aŭtomata Linifaldo rompas liniojn
   nur ĉe spacetoj.

Normale la marĝeno estas post 70 signoj, sed vi povas ŝanĝi tion per
la ordono C-x f.  Vi devus doni la marĝenon kiu vi deziras por nombra
argumento.

>> Tajpu C-x f kun la argumento 20.  (C-u 2 0 C-x f).
   Tajpu ia tekston kaj rigardu kiel Emakso faldas liniojn po 20
   signoj.  Refiksu la marĝenon al 70 per C-x f.

Se vi faras ŝanĝojn meze de alineo, la Aŭtomata Linifalda reĝimo ne
refaldas ĝin por vi.
Por rearanĝi la alineon, tajpu M-q (Meta-q) dum la kursoro estas
interne de la alineo.

>> Movu la kursoron en la antaŭan alineon kaj tajpu M-q.


* SERĈADO
---------

Emakso povas serĉi aperojn de ĉenoj (tiuj estas aroj da apudaj signoj
aŭ vortoj), aŭ antaŭen tra la teksto, aŭ malantaŭen.  Serĉi ĉenon
estas kursormova ordono; ĝi movas la kursoron al la sekvanta loko kie
la ĉeno aperas.

La Emaksa serĉa ordono diferencas de la serĉaj ordonoj de la plimulto
da redaktiloj per tio, ke ĝi estas "dumtajpa".  Tio signifas ke la
serĉo okazas dum vi tajpas la ĉenon por priserĉi.

La ordono por komenci serĉon estas C-s por la serĉo antaŭen, kaj C-r
por la serĉo malantaŭen.  SED ATENDU!  Ankoraŭ ne provu ilin nun.

Kiam vi tajpos C-s, vi vidos la ĉenon "I-search" aperi invite en la
eĥa areo.  Ĉi tio informas vin, ke Emakso estas en la dumtajpa serĉo,
atendante ke vi tajpu la ĉenon kies aperon vi deziras trovi.  <Return>
finas serĉon.

>> Nun tajpu C-s por komenci serĉon.  MALRAPIDE, unuliterope, tajpu la
   vorton "kursoro", paŭzante post ĉiu tajpita signo por vidi, kio
   okazas al la kursoro.
   Nun vi estas serĉinta por "kursoro", unufoje.
>> Tajpu C-s denove, por serĉi la sekvan aperon de "kursoro".
>> Nun tajpu <Backspace> kvarfoje kaj rigardu kiamaniere la kursoro
   moviĝas.
>> Tajpu <Return> por fini la serĉon.

Ĉu vi vidis, kio okazis?  Emakso, en dumtajpa serĉo, penas iri al la
apero de la ĉeno kiun vi jam tajpis.  Por iri al la sekvanta apero de
"kursoro" nur tajpu C-s denove.  Se nenia ajn apero ekzistas, Emakso
pepas kaj informas vin ke la serĉo ĉi-foje "malsukcesis".  Ankaŭ C-g
finus la serĉon.

RIMARKU: Ĉe iuj sistemoj, C-s senmovigas la ekranon kaj vi vidos ne
plu da eligo de Emakso.  Ĉi tio indikas ke operaciuma "trajto" nomata
"fluregulado" interkaptis la C-s kaj ne permesas al ĝi trapasi al
Emakso.  Por removebligi la ekranon, tajpu C-q.  Konsultu la sekcion
"Spontaneous Entry to Incremental Search" en la Emaksa manlibro por
konsilo pri tio, kiel trakti ĉi tiun "trajton".

Se, meze de dumtajpa serĉo, vi tajpos <Retroviŝu>, vi rimarkos ke la
lasta signo en la serĉata ĉeno forviŝiĝas, kaj la serĉo retroiras al
la ĵusa loko de la serĉo.  Ekzemple, supozu ke vi tajpis "k", por
serĉi la unuan aperon de "k".  Nun se vi tajpus "u, la kursoro moviĝus
al la unua apero de "ku".  Nun tajpu <Retroviŝu>.  Ĉi tio forigos la
"u" de el la serĉata ĉeno, kaj la kursoro moviĝos reen al la unua
apero de "k".

Se, meze de dumtajpa serĉo, vi tajpos STIRan aŭ META-signon
(esceptante kelkajn signojn, specialajn en la serĉo, ekzemple C-s kaj
C-r), la serĉo iĝos finita.

La C-s komencas serĉon kiu celas iun ajn aperon de la serĉata ĉeno
POST la nuna kursorloko.  Se vi deziras serĉi ion supre en la teksto,
tajpu C-r anstataŭe.  Ĉio dirita pri C-s validas pri C-r, krom ke la
direkto de la serĉo estas inversa.


* MULTAJ FENESTROJ
------------------

Unu el la agrablaj trajtoj de Emakso estas ke vi povas havi plurajn
fenestrojn sur la ekrano samtempe.

>> Movu la kursoron al tiu ĉi linio kaj tajpu "C-u 0 C-l" (kun Stira
   lo, ne Stira unu).

>> Nun tajpu "C-x 2", kio fendos la ekranon en du fenestrojn.
   Ambaŭ fenestroj vidigas ĉi tiun lernilon.  La kursoro restas en la
   supra fenestro.

>> Tajpu C-M-v por rulumi la malsupran fenestron
   (Se vi ne havas veran Meta-klavon, tajpu Esc C-v.)

>> Tajpu "C-x o" ("o" de la angla vorto "other", "alia") por movi la
   kursoron en la malsupran fenestron.
>> Uzu C-v kaj M-v en la malsupra fenestro por rulumi ĝin.
   Daŭrigu legi ĉi tiun instrukcion en la supra fenestro.

>> Tajpu C-x o denove por movi la kursoron reen en la supran fenestron.
   La kursoro en la supra fenestro estas ĝuste kie ĝi estis antaŭe.

Vi povas plu uzi C-x o por moviĝi inter fenestroj.  Ĉiu fenestro havas
sian propran kursorlokon, sed nur unu fenestro ja montras la kursoron.
Ĉiuj el la ordinaraj redaktaj ordonoj apartenas al la fenestro kiu
enhavas la kursoron.  Ni nomas tiun la "elektita fenestro".

La ordono C-M-v estas utilega kiam vi redaktas tekston en unu fenestro
kaj uzas la alian fenestron nur por konsulti.  Tiel vi ĉiam povas havi
la kursoron en la fenestro kie vi redaktas, kaj laŭbezone rulumi tra
la alia fenestro per C-M-v.

C-M-v estas ekzemplo de STIR-META-signo.  Se vi havas veran
META-klavon, vi povas tajpi C-M-v premante ambaŭ STIR kaj META, kaj
tajpante v.  Ne gravas, ĉu STIR aŭ META "venas unue," ĉar ili ambaŭ
funkcias kiel modifiloj de la signo kiun vi tajpas.

Se vi ne havas veran META-klavon, kaj uzas <ESC> anstataŭe, la ordo
gravas: vi devas tajpi <ESC> kaj poste C-v, ĉar "C-ESC v" ne funkcias.
Tiel estas ĉar <ESC> estas ne modifilo, sed memstara signo.

>> Tajpu "C-x 1" (en la supra fenestro) por forigi la malsupran
   fenestron.

(Se vi tajpus C-x 1 en la malsupra fenestro, tio forigus la supran.
Pensu pri tiu ordono kiel "restigu nur unu fenestron -- la fenestron
en kiu mi jam estas.")

Ne estas nepraĵo havi la saman bufron en ambaŭ fenestroj.  Se vi uzas
"C-x C-f" por trovi dosieron en unu fenestro, la alia fenestro ne
ŝanĝiĝas.  Vi povas trovi dosieron sendepende en ĉiu fenestro.

Jen alia maniero uzi du fenestrojn por montri du malsamajn aferojn:

>> Tajpu "C-x 4 C-f", kaj sekve la nomon de unu el viaj dosieroj.
   Finu per <Return>.  Rimarku ke la elektita dosiero aperas en la
   malsupra fenestro.  Ankaŭ la kursoro iras tien.

>> Tajpu "C-x o" por retroiri en la supran fenestron, kaj "C-x 1" por
   forigi la malsupran fenestron.


* REKURSIAJ REDAKTAJ NIVELOJ
----------------------------

Iam vi eniros ion nomatan "rekursia redakta nivelo".  Tio estas
indikata per ortaj krampoj en la reĝimlinio, ĉirkaŭ la rondaj krampoj
de la nomo de la ĉefreĝimo.  Ekzemple, vi eble vidos [(Fundamental)]
anstataŭ (Fundamental).

Por eliri el la rekursia redakta nivelo, tajpu Esc Esc Esc.  Tio estas
universala "elira" ordono.  Vi ankaŭ povas uzi ĝin por forigi kromajn
fenestrojn, aŭ por eliri el la bufreto.

>> Tajpu "M-x" por eniri la bufreton; kaj poste tajpu "Esc Esc Esc"
   por eliri.

Oni ne povas uzi C-g por eliri el rekursia redakta nivelo.  Tiel estas
ĉar C-g estas uzata por aboli ordonojn kaj argumentojn INTERNE DE la
rekursia redakta nivelo.


* KIEL AKIRI PLUAN HELPON
-------------------------

En ĉi tiu lernilo ni penis provizi nur tiom da informo, kiom necesas
por ebligi al vi ekuzi Emakson.  Emakso disponigas tiom da ebloj, ke
oni ne povas prezenti ĉiom da ili ĉi tie.  Tamen, vi eble dezirus
lerni plu pri Emakso, ĉar ĝi havas multajn aliajn utilajn trajtojn.
Emakso provizas ordonojn por legi dokumentaĵon pri Emaksaj ordonoj.
Ĉiuj el tiuj ĉi "helpaj" ordonoj komenciĝas per la signo C-h, kiu
estas nomata "la Help-signo".

Por uzi la Helpajn ordonojn, tajpu la signon C-h, kaj sekve signon
indikantan kian helpon vi deziras.  Se vi estas vere perdita, tajpu
C-h ?  kaj Emakso montros al vi la specojn de helpo kiujn ĝi povas
provizi.  Se vi tajpis C-h kaj decidas ke vi ne deziras helpon, simple
tajpu C-g por aboli ĝin.

(En iuj lokoj oni ŝanĝas la signifon de la signo C-h.  Oni prefere ne
faru tion por ĉiuj uzantoj, do vi rajtas plendi al la sistemestro.
Dume, se C-h ne montras mesaĝon pri helpo ĉe la fundo de la ekrano,
provu tajpi la F1-klavon aŭ "M-x help <Return>" anstataŭe.)

La plej baza HELPA rimedo estas "C-h c".  Tajpu C-h, la signon c, kaj
ordonan signon aŭ sekvencon; sekve de tio Emakso montras koncizegan
priskribon pri la ordono.

>> Tajpu C-h c C-p.
   En la eĥa areo devas aperi proksimume tia mesaĝo:

	C-p runs the command previous-line

Ĉi tio diras al vi la "nomon de la funkcio".  Funkciaj nomoj servas
ĉefe por agordi kaj etendi Emakson.  Sed ĉar funkciaj nomoj estas
elektitaj por indiki kion la ordono faras, ili ankaŭ servas kiel
koncizega priskribo -- sufiĉa por rememorigi vin pri ordonoj kiujn vi
jam lernis.

Ankaŭ la plursignaj ordonoj, ekzemple "C-x C-s" kaj "<ESC>v", estas
egale eblaj post C-h c.

Por akiri pli da informo pri ordono, uzu C-h k anstataŭ C-h c.

>> Tajpu C-h k C-p.

Ĉi tio montras la plenan priskribon de la funkcio, aldone al ĝia nomo,
en Emaksa fenestro.  Fininte legi la eligaĵon, tajpu "C-x 1" por
forigi la helptekston.  Ne nepras fari tion tuj.  Vi povas redakti
konsultante la helptekston, kaj poste tajpi C-x 1.

Jen iom da aliaj utilaj elektoj por C-h:

   C-h f	Priskribu funkcion.  Vi tajpas la nomon de la funkcio.

>> Provu tajpi C-h f previous-line<Return>.
   Ĉi tio vidigas ĉiom da la informo kiun Emakso havas pri la funkcio
   efektiviganta la C-p ordonon.

   C-h a        Rilate al Ordono ("à propos").  Tajpu ŝlosilvorton kaj
		Emakso listigos ĉiujn el la ordonoj kies nomoj enhavas
		tiun ŝlosilvorton.  Vi povas alvoki tiajn ordonoj per
		META-x.  Por iom da ordonoj, Rilate al Ordono ankaŭ
		listigos unu- aŭ dusignan sekvencon alvokantan la
		saman ordonon.

>> Tajpu C-h a file<Return>.

Sekve de ĉi tio vi vidos en aparta fenestro liston da ĉiuj M-x ordonoj
enhavantaj "file" en sia nomo.  Vi vidos signajn ordonojn listigitaj
apud la respondaj ordonnomoj, ekzemple "C-x C-f" kaj "C-x C-w" apud
"find-file" kaj "write-file".

>> Tajpu C-M-v por rulumi la helpfenestron.  Faru ĉi tion kelkfoje.
>> Tajpu C-x 1 por forigi la helpfenestron.

   C-h i	Vidigu dialogan manlibron (t.n. "Info").  Ĉi tiu
		ordono transportos vin en specialan bufron, nomatan
		"*info*", kie vi povos legi instrukciojn pri la
		pakaĵoj instalitaj en via sistemo.  Ekzemple, tajpu
		"m emacs <Return>" por legi la manlibron pri Emakso.
		Se vi neniam antaŭe uzis Info, tajpu "?", kaj Emakso
		gvidos vin tra la prezento de la ebloj de la informa
		reĝimo.  Finleginte ĉi tiun lernilon, uzu la
		Info-manlibron kiel vian ĉefan dokumentaĵon.


* KROMAJ FUNKCIOJ
-----------------

Pluajn informojn pri Emakso vi povas trovi foliumante ties manlibron,
ĉu paperan (libroforman) aŭ dialogan (en Info -- uzu la Help-menuon aŭ
tajpu "F10 h r").  Du funkcioj kiujn vi probable aparte aprezos estas
la kompletigo, ŝparanta tajpadon, kaj dired, faciliganta manipuladojn
dosierajn.

Kompletigo estas rimedo por eviti redundan tajpadon.  Ekzemple, se vi
volas transiri en la bufron *Messages*, sufiĉas tajpi "C-x b *M<Tab>"
kaj Emakso kompletigos la bufronomon per tiom da signoj, kiom ĝi povos
determini surbaze de tio, kion vi jam tajpis.  La kompletigo estas
priskribita en la Info-manlibro pri Emakso en la nodo "Completion".

Dired ebligas al vi listigi dosierujon (kaj eventuale, ties
subdosierujojn), kaj moviĝi en tiu listo vizitante, alinomante,
forigante kaj alimaniere manipulante la dosierojn.  Dired estas
priskribita en la Info-manlibro pri Emakso en la nodo "Dired".

La manlibro priskribas ankaŭ multajn aliajn apartaĵojn de Emakso.


* FINO
------

Memoru, por definitive eliri el Emakso uzu C-x C-c.  Por eliri en la
ŝelon provizore, tiel ke vi povu reveni en Emakson poste, uzu C-z.

Ĉi tiu lernilo estas farita kun la intenco esti komprenebla por ĉiu
nova uzanto, do se vi trovis ion ajn malklara, ne restu kulpigante vin
mem -- plendu!  La adreso por la Esperanta Traduka Teamo estas
<[e-mail]>.


* KOPIADO
---------

Ĉi tiu lernilo devenas el longa vico da Emaksaj instruaj dosieroj ekde
la dosiero verkita de Stuart Cracraft por la originala Emakso.

Ĉi tiu versio de la lernilo, same kiel GNU Emakso, estas metita sub
kopirajton, kaj venas kun permeso por disdoni kopiojn se certaj
kondiĉoj estas observataj:

   Copyright (C) 1985, 1999, 2001, 2002, 2005,
   2007, 2008 Free Software Foundation, Inc.

   Ĉi tiu dosiero estas parto de "GNU Emacs".
 
   "GNU Emacs" estas libera programverko; vi povas ĝin pludistribui
   kaj/aŭ modifi je la kondiĉoj de la GNUa Ĝenerala Publika Permesilo,
   eldonita de "Free Software Foundation", laŭ la versio 3 de tiu
   Permesilo aŭ, se vi preferas, ajna posta versio.
 
   Ni distribuas ĉi tiun programon esperante ke ĝi estos utila, tamen
   SEN IA AJN GARANTIO, i.a. sen la implica garantio pri
   SURMERKATIGEBLO aŭ TAŬGECO POR IU KONKRETA CELO.  Pliajn detalojn
   vidu en la GNUa Ĝenerala Publika Permesilo.
 
   Ekzemplero de la GNUa Ĝenerala Publika Permesilo devas esti
   liverita al vi kun ĉi tiu programo; se vi ĝin ne ricevis, turnu vin
   al: Free Software Foundation, Inc., 51 Franklin Street, Fifth
   Floor, Boston, MA 02110-1301, USA.

Bonvole legu la dosieron COPYING kaj sekve donu kopiojn de GNU Emakso
al viaj amikoj.  Helpu ekstermi programaran obstrukcismon
("proprietigon") per uzado, verkado kaj kunhavigo de libera
programaro!
  
Ĉi tiun lernilon esperantigis D. Dale Gulledge; la tradukon reviziis
kaj kompletigis Sergio B. Pokrovskij.

--- end of TUTORIAL.eo ---

;;; Local Variables:
;;;   coding: latin-3
;;; End:

;; arch-tag: ee436ebb-58b6-4102-9402-1e92c33966e9