X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=lib%2Fsorter.h;h=d1f059fccec58f0240748dc7dc0777cb78eaa27d;hb=9fbdf10b4915874aad2eb98087293e5c721d3eb2;hp=65a9553af1a4f1fc63d43551b82e74360460729c;hpb=f8e62f4895a583184ca0c6878ad23b289ee229e9;p=libucw.git

diff --git a/lib/sorter.h b/lib/sorter.h
index 65a9553a..d1f059fc 100644
--- a/lib/sorter.h
+++ b/lib/sorter.h
@@ -21,6 +21,8 @@
  *			deleted as soon as possible
  *  SORT_INPUT_FILE	input is a file with this name
  *  SORT_INPUT_FB	input is a fastbuf stream
+ *			(can be safely NULL if you want to treat original
+ *			input in a different way by file read functions)
  *  SORT_INPUT_FBPAIR	input is a pair of fastbuf streams
  *			(not supported by the presorter)
  *  SORT_OUTPUT_FILE	output is a file with this name
@@ -46,9 +48,11 @@
  *			fetch data belonging to a just fetched key and store
  *			them to memory following the key, but not over limit.
  *			Returns a pointer to first byte after the data
- *			or NULL if the data don't fit.
- *			Important: keys carrying no data must be position
- *			independent.
+ *			or NULL if the data don't fit. For variable-length
+ *			keys, it can use the rest of SORT_KEY and even return
+ *			pointer before end of the key.
+ *			Important: before PREFIX_fetch_item() succeeds, the key
+ *			must be position independent, the sorter can copy it.
  *  void PREFIX_store_item(struct fastbuf *f, SORT_KEY *k)
  *			[used only with SORT_PRESORT]
  *			write key and all its data read with PREFIX_fetch_data