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`