<html><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div class=""><br class=""></div><div class="">Dear All,</div><div class=""><br class=""></div><div class="">the new version of Texdoc, v3.0, is almost ready to release.</div><div class="">New functions are already merged to the master branch of our</div><div class="">GitHub repository:</div><div class=""><br class=""></div><div class=""><span class="Apple-tab-span" style="white-space:pre"> </span><a href="https://github.com/TeX-Live/texdoc" class="">https://github.com/TeX-Live/texdoc</a></div><div class=""><br class=""></div><div class="">I also updated the README and other documentations in the</div><div class="">repository, and I believe it provides enough information</div><div class="">for you to test the new version!</div><div class=""><br class=""></div><div class="">There are two big features in Texdoc 3.0.</div><div class=""><br class=""></div><div class="">--</div><div class=""><br class=""></div><div class=""><div class="" style="font-family: Ricty-Regular;">1. New option parser</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">Now, you can specify mutiple options like:</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;"><span class="Apple-tab-span" style="white-space:pre"> </span>$ texdoc -vsl foo</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">(this is equivalent to specifying "-v -s -l")</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">Please note that the behavior of the short option "-d" have</div><div class="" style="font-family: Ricty-Regular;">been changed. It *requires* an argument without "=", e.g.:</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;"><span class="Apple-tab-span" style="white-space:pre"> </span>$ texdoc -d score bar</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">(this is equivalent to specifying "--debug=score")</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">I added a new option "-D" as a short version of "--debug=all".</div><div class="" style="font-family: Ricty-Regular;">Please see the help text for more details.</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">2. Fuzzy search</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">When the normal search can't find any document in TeX Live,</div><div class="" style="font-family: Ricty-Regular;">Texdoc will execute fuzzy search on the list of package names</div><div class="" style="font-family: Ricty-Regular;">without user-interactions. The results of fuzzy search are</div><div class="" style="font-family: Ricty-Regular;">shown by "info" message.</div><div class="" style="font-family: Ricty-Regular;">(you can see that with the command line option "-v")</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">The default allowance of Levenshtein distance is 5.</div><div class="" style="font-family: Ricty-Regular;">You can change this default value by specifying "fuzzy_level"</div><div class="" style="font-family: Ricty-Regular;">in your texdoc.cnf:</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;"><div class=""><span class="Apple-tab-span" style="white-space:pre"> </span>fuzzy_level = 3</div></div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">If "fuzzy_level" set to 0, the feature will be disabled.</div></div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">--</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">For the quick understanding, the slide I used for a talk in</div><div class="" style="font-family: Ricty-Regular;">BachoTeX 2018 is available from Speaker Deck:</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;"><span class="Apple-tab-span" style="white-space:pre"> </span><a href="https://speakerdeck.com/wtsnjp/texdoc3" class="">https://speakerdeck.com/wtsnjp/texdoc3</a></div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">More detailed information can be found in the help text and</div><div class="" style="font-family: Ricty-Regular;">the documentation (texdoc.tex).</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">The only remaining tasks for releasing v3.0 is updating</div><div class="" style="font-family: Ricty-Regular;">documentations (mostly done) and further testing. In addition,</div><div class="" style="font-family: Ricty-Regular;">the release of Texdoc will be done via CTAN from now on.</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">I'm going to release v3.0 about in two weeks. If you are</div><div class="" style="font-family: Ricty-Regular;">interested in and have a time, please test the new features.</div><div class="" style="font-family: Ricty-Regular;">When you find any problems or bugs, please report that here</div><div class="" style="font-family: Ricty-Regular;">(the mailing list) or by using GitHub issues.</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">One more thing (IMPORTANT for distributors): from v3.0, we won't</div><div class="" style="font-family: Ricty-Regular;">include Data.tlpdb.lua (the pseudo cache file) in our repository.</div><div class="" style="font-family: Ricty-Regular;">If your distribution do not ship the tlpdb, you have to</div><div class="" style="font-family: Ricty-Regular;">pre-generate the pseudo cache file to make Texdoc workable.</div><div class="" style="font-family: Ricty-Regular;">To do this, tools/gen-datafiles would be helpful at this point.</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;"><br class=""></div><div class="" style="font-family: Ricty-Regular;">Best regards,</div><div class="" style="font-family: Ricty-Regular;">Takuto</div><div class="" style="font-family: Ricty-Regular;"><br class=""></div></body></html>