2015-10-16 7:45 GMT+09:00 KATO Tomoyuki <tomo@dream.daynight.jp>:
Hi Akihiro, Andreas,
Ahhhhhh... this must be a bug (I made...).
Cause: The tool is simply adding the new strings to common-rst [1]. So, the unused strings are remaining...
Background (from my understand): Each document uses the common contents. However, each document has the different exclude_patterns, because Sphinx warns if there are unused files. Therefore, each document has a partial common-rst file, not a whole common-rst.
Is it applied to sphinx-build -b gettext? As far as I tested on documents using RST in openstack-manuals, there is no warning. tox -e generatepot-rst -- user-guide or others. I just proposed https://review.openstack.org/235611 Doesn't it work? Akihiro
Solution: ... I don't have a good idea as of now... Add a new document that contains all common file? OpenStack Common Guide (dummy, just to create pot file :)
I will re-consider the situation. Any idea is welcome.
Regards, KATO Tomoyuki
[1] https://github.com/openstack/openstack-manuals/blob/master/tools/generatepot... [2] https://github.com/openstack/openstack-manuals/blob/master/doc/install-guide...
Thanks Andreas,
It seems I ran "tox -e generatepot-rst" on an unrelated doc. Now it works.
Regarding the problem that I see obsolete strings in the common-rst pot, I will investigate more. There is no need to rush, but it is worth fixed soon.
Akihiro
2015-10-16 2:24 GMT+09:00 Andreas Jaeger <aj@suse.com>:
On 10/15/2015 07:02 PM, Akihiro Motoki wrote:
Hi team,
During translation of common-rst in Zanata, I found a bit odd entries in openstack-manuals/doc/common-rst/source/locale/common-rst.pot.
When and how is openstack-manuals/common-rst updated?
For example, we see the following in common-rst.pot: --- #: ../common/app_support.rst:3 msgid "Community support" msgstr ""
#: ../common/app_support.rst:5 msgid "Community Support" msgstr "" ----
However, we actually have only the first entry in common-rst/*.rst: --- $ grep -r 'Community Support' doc/common-rst/*.rst $ grep -r 'Community support' doc/common-rst/*.rst doc/common-rst/app_support.rst:Community support ---
If you look at app_support.rst, we have only the first one. Where does the second one come from?
In tools/generatepot-rst.sh, processing on 'common-rst' is skipped. I wonder which script we update common-rst.pot.
generatepot-rst.sh generates the file in every invocation, just run "tox -e generatepot-rst -- user-guide"
A git status afterwards will show: ... modified: doc/common-rst/source/locale/common-rst.pot modified: doc/user-guide/source/locale/user-guide.pot
Just the invocation " tox -e generatepot-rst -- common-rst" is skipped
Still that does not answer your initial question why the line is there twice. Debugging is welcome,
Andreas -- Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany GF: Felix Imendörffer, Jane Smithard, Graham Norton, HRB 21284 (AG Nürnberg) GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126