| 1 |
Source: csv-mode |
| 2 |
Section: lisp |
| 3 |
Priority: optional |
| 4 |
Maintainer: Debian Emacsen team <[email protected]> |
| 5 |
Uploaders: Xiyue Deng <[email protected]> |
| 6 |
Build-Depends: debhelper-compat (= 13), |
| 7 |
dh-elpa |
| 8 |
Rules-Requires-Root: no |
| 9 |
Testsuite: autopkgtest-pkg-elpa |
| 10 |
Standards-Version: 4.7.2 |
| 11 |
Vcs-Browser: https://salsa.debian.org/emacsen-team/csv-mode |
| 12 |
Vcs-Git: https://salsa.debian.org/emacsen-team/csv-mode.git |
| 13 |
Homepage: https://elpa.gnu.org/packages/csv-mode.html |
| 14 |
|
| 15 |
Package: elpa-csv-mode |
| 16 |
Architecture: all |
| 17 |
Depends: ${elpa:Depends}, ${misc:Depends} |
| 18 |
Recommends: emacs |
| 19 |
Enhances: emacs |
| 20 |
Description: Emacs major mode for editing comma/char separated values |
| 21 |
This package implements CSV mode, a major mode for editing records |
| 22 |
in a generalized CSV (character-separated values) format. It binds |
| 23 |
files with prefix ".csv" to `csv-mode' (and ".tsv" to `tsv-mode') in |
| 24 |
`auto-mode-alist'. |
| 25 |
. |
| 26 |
In CSV mode, the following commands are available: |
| 27 |
. |
| 28 |
- C-c C-s (`csv-sort-fields') and C-c C-n (`csv-sort-numeric-fields') |
| 29 |
respectively sort lexicographically and numerically on a |
| 30 |
specified field or column. |
| 31 |
. |
| 32 |
- C-c C-r (`csv-reverse-region') reverses the order. (These |
| 33 |
commands are based closely on, and use, code in `sort.el'.) |
| 34 |
. |
| 35 |
- C-c C-k (`csv-kill-fields') and C-c C-y (`csv-yank-fields') kill |
| 36 |
and yank fields or columns, although they do not use the normal |
| 37 |
kill ring. C-c C-k can kill more than one field at once, but |
| 38 |
multiple killed fields can be yanked only as a fixed group |
| 39 |
equivalent to a single field. |
| 40 |
. |
| 41 |
- `csv-align-mode' keeps fields visually aligned, on-the-fly. |
| 42 |
It truncates fields to a maximum width that can be changed per-column |
| 43 |
with `csv-align-set-column-width'. |
| 44 |
Alternatively, C-c C-a (`csv-align-fields') aligns fields into columns |
| 45 |
and C-c C-u (`csv-unalign-fields') undoes such alignment; |
| 46 |
separators can be hidden within aligned records (controlled by |
| 47 |
`csv-invisibility-default' and `csv-toggle-invisibility'). |
| 48 |
. |
| 49 |
- C-c C-t (`csv-transpose') interchanges rows and columns. For |
| 50 |
details, see the documentation for the individual commands. |
| 51 |
. |
| 52 |
- `csv-set-separator' sets the CSV separator of the current buffer, |
| 53 |
while `csv-guess-set-separator' guesses and sets the separator |
| 54 |
based on the current buffer's contents. |
| 55 |
`csv-guess-set-separator' can be useful to add to the mode hook |
| 56 |
to have CSV mode guess and set the separator automatically when |
| 57 |
visiting a buffer: |
| 58 |
. |
| 59 |
(add-hook 'csv-mode-hook 'csv-guess-set-separator) |
| 60 |
. |
| 61 |
CSV mode can recognize fields separated by any of several single |
| 62 |
characters, specified by the value of the customizable user option |
| 63 |
`csv-separators'. CSV data fields can be delimited by quote |
| 64 |
characters (and must if they contain separator characters). This |
| 65 |
implementation supports quoted fields, where the quote characters |
| 66 |
allowed are specified by the value of the customizable user option |
| 67 |
`csv-field-quotes'. By default, the both commas and tabs are considered |
| 68 |
as separators and the only field quote is a double quote. |
| 69 |
These user options can be changed ONLY by customizing them, e.g. via M-x |
| 70 |
customize-variable. |
| 71 |
. |
| 72 |
CSV mode commands ignore blank lines and comment lines beginning |
| 73 |
with the value of the buffer local variable `csv-comment-start', |
| 74 |
which by default is #. The user interface is similar to that of |
| 75 |
the standard commands `sort-fields' and `sort-numeric-fields', but |
| 76 |
see the major mode documentation below. |
| 77 |
. |
| 78 |
The global minor mode `csv-field-index-mode' provides display of |
| 79 |
the current field index in the mode line, cf. `line-number-mode' |
| 80 |
and `column-number-mode'. It is on by default. |