/usr/share/doc/elpa-kv/README.creole is in elpa-kv 0.0.19+git20140108.7211484-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 | A collection of tools for dealing with key/value data structures such
as plists, alists and hash-tables.
=== kvalist->filter-keys alist &rest keys ===
Return the //alist// filtered to the //keys// list.
Only pairs where the car is a [[member]] of //keys// will be returned.
=== kvalist->hash alist &rest hash-table-args ===
Convert //alist// to a HASH.
//hash-table-args// are passed to the hash-table creation.
=== kvalist->keys alist ===
Get just the keys from the alist.
=== kvalist->plist alist ===
Convert an alist to a plist.
=== kvalist->values alist ===
Get just the values from the alist.
=== kvalist-keys->* alist fn ===
Convert the keys of //alist// through //fn//.
=== kvalist-keys->symbols alist ===
Convert the keys of //alist// into symbols.
=== kvalist-sort alist pred ===
Sort //alist// (by key) with //pred//.
=== kvalist-sort-by-value alist pred ===
Sort //alist// by value with //pred//.
=== kvalist2->alist alist2 car-key cdr-key &optional proper ===
Reduce the //alist2// (a list of alists) to a single alist.
//car-key// is the key of each alist to use as the resulting key and
//cdr-key// is the key of each alist to user as the resulting cdr.
If //proper// is [[t]] then the alist is a list of proper lists, not
cons cells.
=== kvalist2->filter-keys alist2 &rest keys ===
Return the //alist2// (a list of alists) filtered to the //keys//.
=== kvalist2->plist alist2 ===
Convert a list of alists too a list of plists.
=== kvcmp a b ===
Do a comparison of the two values using printable syntax.
Use this as the function to pass to [[sort]].
=== kvdotassoc expr table ===
Dotted expression handling with [[assoc]].
=== kvdotassoc-fn expr table func ===
Use the dotted //expr// to access deeply nested data in //table//.
//expr// is a dot separated expression, either a symbol or a string.
For example:
{{{
"a.b.c"
}}}
or:
{{{
'a.b.c
}}}
If the //expr// is a symbol then the keys of the alist are also
expected to be symbols.
//table// is expected to be an alist currently.
//func// is some sort of [[assoc]] like function.
=== kvdotassq expr table ===
Dotted expression handling with [[assq]].
=== kvhash->alist hash ===
Convert //hash// to an ALIST.
=== kvmap-bind args sexp seq ===
A hybrid of [[destructuring-bind]] and [[mapcar]]
//args// shall be of the form used with [[destructuring-bind]]
Unlike most other mapping forms this is a macro intended to be
used for structural transformations, so the expected usage will
be that //args// describes the structure of the items in //seq//, and
//sexp// will describe the structure desired.
=== kvplist->alist plist ===
Convert //plist// to an alist.
The keys are expected to be :prefixed and the colons are removed.
The keys in the resulting alist are symbols.
=== kvplist->filter-keys plist &rest keys ===
Filter the plist to just those matching //keys//.
//keys// must actually be :-less symbols.
[[kvalist->filter-keys]] is actually used to do this work.
=== kvplist->merge &rest plists ===
Merge the 2nd and subsequent plists into the first, clobbering values set
by lists to the left.
=== kvplist2->filter-keys plist2 &rest keys ===
Return the //plist2// (a list of plists) filtered to the //keys//.
|