Maniphest T56774

Variations on repositories and online documentation
Closed, ArchivedTO DO
Actions

Assigned To
Brecht Van Lommel (brecht)
Authored By
Hoang Duy Tran (hoangduytran)
Sep 12 2018, 11:12 AM
Tags
None
Subscribers
Brecht Van Lommel (brecht)
Hoang Duy Tran (hoangduytran)

Description

A while back, while translating the User Reference Manual, the glossary entry for 'timecode', I noticed some technical error in the explanation, as seen here a screen capture of my local copy

where it said

Timecode: "A coded signal on videotape or film giving information about the frame number, time of recording, or exposure."

After searched online for the "exposure" part and confirmed my suspicion that a structure to store timecode could not be used for storing exposure values, I then went online, IRC at #blenderwiki, and consulted Bastien, we both came to the conclusion that there is an error in the definition, in Bastien's words "there is a typo" (typographical error). I then noticed that all other translations had been suspended, disallowed accesses (even today). I then took a look again at the definition of the 'timecode' and it has changed to:

Timecode
A coded signal on videotape or film giving information about the frame number and time the frame was recorded. Timecodes are used to sync media between different recording devices, including both audio and video.

(a much clearcut definition in my opinion). I suspected changes had been done to the SVN master repository but after checking my local, using

svn status -u

I only see two changes:

  • 4431 manual/getting_started/installing/linux.rst
  • 4431 manual/editors/graph_editor/introduction.rst

which was done recently

r4433 | brecht | 2018-09-12 08:46:00 +0100 (Wed, 12 Sep 2018) | 3 lines
Changed paths:

M /trunk/blender_docs/manual/getting_started/installing/linux.rst

and

r4432 | fanthomas | 2018-09-07 19:13:38 +0100 (Fri, 07 Sep 2018) | 1 line
Changed paths:

M /trunk/blender_docs/manual/editors/graph_editor/introduction.rst

There appears to be something fishy happening on the management of changes on the SVN.

Related Objects

Event Timeline

Hoang Duy Tran (hoangduytran) created this task.Sep 12 2018, 11:12 AM
Hoang Duy Tran (hoangduytran) updated the task description.Sep 12 2018, 11:15 AM
Hoang Duy Tran (hoangduytran) updated the task description.Sep 12 2018, 11:17 AM
Brecht Van Lommel (brecht) changed the task status from Unknown Status to Unknown Status.Sep 12 2018, 11:20 AM
Brecht Van Lommel (brecht) claimed this task.
Brecht Van Lommel (brecht) added a subscriber: Brecht Van Lommel (brecht).

The change was done almost a month ago, you must have already updated your repository since then.
https://developer.blender.org/rBM4417

Hoang Duy Tran (hoangduytran) updated the task description.Sep 12 2018, 11:22 AM
Hoang Duy Tran (hoangduytran) updated the task description.Sep 12 2018, 11:35 AM
Hoang Duy Tran (hoangduytran) added a comment.Sep 12 2018, 12:52 PM

Thank you for the feedback, Brencht, I have found the different behavior between generated POT files from RST and the PO files edited using POEDIT created problem on running

make gettext
sphinx-intl update -p build/locale -l <language>

sphynx-intl reported
Update: <file> +1, -1

but when you check to actual content, IT HASN'T. This, I think, is due to

msgid in the POT file formatted as

msgid "<text>" (on the same line)

while

msgid in the PO file is formatted as

msgid ""
"<text>"

leading to the replacement of changes could not be performed, but sphynx-intl doesn't appear to capture the failure and report faithfully as such, a very dangerous TRAP. I have just run this

make gettext
sphinx-intl update -p build/locale -l <language>

twice in my local hard-drive and verify that changes DID NOT take place if the PO file has been used with POEDIT tool.