doc/settings.md in traject-0.15.0 vs doc/settings.md in traject-0.16.0

- old
+ new

@@ -2,11 +2,12 @@ Traject settings are a flat list of key/value pairs -- a single Hash, not nested. Keys are always strings, and dots (".") can be used for grouping and namespacing. -Values are usually strings, but occasionally something else. +Values are usually strings, but occasionally something else. String values can be easily +set via the command line. Settings can be set in configuration files, usually like: ~~~ruby settings do @@ -15,10 +16,15 @@ ~~~~ or on the command line: `-s key=value`. There are also some command line shortcuts for commonly used settings, see `traject -h`. +`provide` will only set the key if it was previously unset, so first time to set 'wins'. And command-line +settings are applied first of all. It's recommended you use `provide`. + +`store` is also available, and forces setting of the new value overriding any previous value set. + ## Known settings * `debug_ascii_progress`: true/'true' to print ascii characters to STDERR indicating progress. Note, yes, this is fixed to STDERR, regardless of your logging setup. * `.` for every batch of records read and parsed @@ -99,6 +105,6 @@ indexing machine, as these threads will mostly be waiting on Solr. Speed/capacity of your solr might be more relevant. Note that processing_thread_pool threads can end up submitting to solr too, if solrj_writer.thread_pool is full. -* `writer_class_name`: a Traject Writer class, used by indexer to send processed dictionaries off. Default Traject::SolrJWriter, also available Traject::JsonWriter. See Traject::Indexer for more info. Command line shortcut `-w` \ No newline at end of file +* `writer_class_name`: a Traject Writer class, used by indexer to send processed dictionaries off. Default Traject::SolrJWriter, also available Traject::JsonWriter. See Traject::Indexer for more info. Command line shortcut `-w`