diff doc/tracker_templates.txt @ 7045:ca90f7270cd4 issue2550923_computed_property

merge from main tip. This should fix test failure in Markdown2TestCase.test_string_markdown_code_block_attribute by merging html diff method used in tests.
author John Rouillard <rouilj@ieee.org>
date Mon, 07 Nov 2022 22:58:38 -0500
parents 00fe67eb8a91
children 6985f0ff3df3
line wrap: on
line diff
--- a/doc/tracker_templates.txt	Thu Apr 21 16:54:17 2022 -0400
+++ b/doc/tracker_templates.txt	Mon Nov 07 22:58:38 2022 -0500
@@ -5,19 +5,27 @@
 The templates distributed with Roundup are stored in the "share" directory
 nominated by Python. On Unix this is typically
 ``/usr/share/roundup/templates/`` (or ``/usr/local/share...``) and
-on Windows this is ``c:\python22\share\roundup\templates\``.
+on Windows this is ``c:\python27\share\roundup\templates\``.
 
 The template loading looks in four places to find the templates:
 
 1. *share* - eg. ``<prefix>/share/roundup/templates/*``.
    This should be the standard place to find them when Roundup is
-   installed.
-2. ``<roundup.admin.__file__>/../templates/*``.
+   installed running setup.py from source.
+2. ``install_dir``/../<prefix>/share/....``, where prefix is the
+   Python's ``sys.prefix``. ``sys.base_prefix`` or 
+   `sys.base_prefix/local``. This finds templates (and locales)
+   installed by pip. E.G. in a virtualenv located at (``sys.prefix``):
+   ``/tools/roundup``, roundup would be at:
+   ``/tools/roundup/lib/python3.6/site-packages/roundup``. The
+   templates would be at:
+   ``/tools/roundup/lib/python3.6/site-packages/tools/roundup/share/roundup/templates/``.
+3. ``<roundup.admin.__file__>/../../share/roundup/templates/*``.
    This will be used if Roundup's run in the distro (aka. source)
    directory.
-3. ``<current working dir>/*``.
+4. ``<current working dir>/*``.
    This is for when someone unpacks a 3rd-party template.
-4. ``<current working dir>``.
+5. ``<current working dir>``.
    This is for someone who "cd"s to the 3rd-party template dir.
 
 Templates contain:

Roundup Issue Tracker: http://roundup-tracker.org/