Update docs

Author: hit9

docs/locales/zh/LC_MESSAGES/changelog.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: bitproto 0.4.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-07-31 14:53+0800\n"
+"POT-Creation-Date: 2022-02-24 10:21+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -22,32 +22,40 @@ msgid "Changelog"
 msgstr "版本历史"
 
 #: ../../../changes.rst:6 0d36e7c261c74f93925a9d1cac8e349c
+msgid "Version 0.4.4"
+msgstr ""
+
+#: ../../../changes.rst:8 6e50f748d8ad43cd83147fd3ad35c103
+msgid "Minor fix compiler setup.py path issue."
+msgstr ""
+
+#: ../../../changes.rst:13 0d36e7c261c74f93925a9d1cac8e349c
 msgid "Version 0.4.2"
 msgstr ""
 
-#: ../../../changes.rst:8 45ad5c975eee4893a337aa1148e9f843
+#: ../../../changes.rst:15 45ad5c975eee4893a337aa1148e9f843
 msgid "Allow using ``type`` as message field name, fixes issue #39."
 msgstr ""
 
-#: ../../../changes.rst:13 0d36e7c261c74f93925a9d1cac8e349c
+#: ../../../changes.rst:20 0d36e7c261c74f93925a9d1cac8e349c
 msgid "Version 0.4.0"
 msgstr ""
 
-#: ../../../changes.rst:15 1f9f362e8f19439e80853d2c8e0be167
+#: ../../../changes.rst:22 1f9f362e8f19439e80853d2c8e0be167
 msgid ""
 "Add support for ``message`` and ``enum`` extensiblity for protocol "
 "backward compatibility."
 msgstr ""
 
-#: ../../../changes.rst:16 fd9a84c95ed546a59f5268431d877be9
+#: ../../../changes.rst:23 fd9a84c95ed546a59f5268431d877be9
 msgid "Cut down the code size of generated language-specific files."
 msgstr ""
 
-#: ../../../changes.rst:17 ccade2fb15534d4bb0569dc800abb83f
+#: ../../../changes.rst:24 ccade2fb15534d4bb0569dc800abb83f
 msgid "Refactor the bitproto compiler."
 msgstr ""
 
-#: ../../../changes.rst:18 2f3010514fd244ef99981b9cbc69e934
+#: ../../../changes.rst:25 2f3010514fd244ef99981b9cbc69e934
 msgid ""
 "Refactor the bitproto serialization mechanism, using language-specific "
 "libraries instead of pure compiler-generated files."

docs/locales/zh/LC_MESSAGES/performance.po

@@ -8,68 +8,68 @@ msgid ""
 msgstr ""
 "Project-Id-Version: bitproto 0.4.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-02-04 10:53+0800\n"
+"POT-Creation-Date: 2022-02-24 10:21+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.0\n"
+"Generated-By: Babel 2.9.1\n"
 
-#: ../../performance.rst:4 a266f980800a4873b6e52dd3cfaa030a
+#: ../../performance.rst:4 3f9fa565a7ad4ff4997b60a9d0f760e2
 msgid "Performance"
 msgstr "性能表现"
 
-#: ../../performance.rst:6 10478d32dda84313819212e35fd5f76b
+#: ../../performance.rst:6 a59f07dbd2b248b3b288b6212f03b198
 msgid ""
 "This document will introduce the performance of bitproto encoding and "
 "decoding, along with the optimization mechanism."
 msgstr "本文将介绍 bitproto 的编解码性能表现和优化机制。"
 
-#: ../../performance.rst:12 d4a1bb6ffa9d4ddcab512c2b28008d61
+#: ../../performance.rst:12 7ac153bc2cbd4ff4b103fa7abea7e64a
 msgid "Performance Benchmark"
 msgstr "性能压测"
 
-#: ../../performance.rst:14 3190f759276b4d60874179656d096feb
+#: ../../performance.rst:14 788f1c312b2e42098abe3a3787611a10
 msgid "Benchmark of bitproto encoding/decoding shows that it runs very fast."
 msgstr "对 bitproto 的编解码的性能压测结果显示，它跑的非常快。"
 
-#: ../../performance.rst:17 e335d07890764b33bf8aa353c441fa90
+#: ../../performance.rst:17 a3f0da4f3bc84c82b8a79e05dc40c74d
 msgid "Unix OS"
 msgstr "Unix 系统"
 
-#: ../../performance.rst:19 4f6e4b9a04244b99903b8bbe44b8fab5
+#: ../../performance.rst:19 c99265ff2d854276848baad8794aed23
 msgid ""
 "On unix like systems (mac, ubuntu etc.), a single encoding/decoding call "
 "costs:"
 msgstr "在类 unix 系统 (mac, ubuntu etc.) 上，一次编码调用或者解码调用占用:"
 
-#: ../../performance.rst:21 d44f4adcfd7d470dabf3a387912d5a75
+#: ../../performance.rst:21 ac31640e500749a1a969649cda6d1967
 msgid "``< 2μs`` in C"
 msgstr "C 语言中 ``< 2μs``"
 
-#: ../../performance.rst:22 54bccc90a1ac4750b4b443d06b43d9a2
+#: ../../performance.rst:22 2b352cc04f784788867abb00b5484ead
 msgid "``< 10μs`` in Go"
 msgstr "Go 语言中 ``<10μs``"
 
-#: ../../performance.rst:23 b69a668531594829810f350e6bdbc095
+#: ../../performance.rst:23 13bef9d15f5141ce97a5d0c1d49f982a
 msgid "``< 1ms`` in Python"
 msgstr "Python 语言中 ``< 1ms``"
 
-#: ../../performance.rst:25 a1c4268f9b0449bb9fc37aa0990af408
+#: ../../performance.rst:25 aa3094853b1b41899a5d8d9fb0e5362e
 msgid ""
 "You can checkout `the detail benchmark results for unix on github "
 "<https://github.com/hit9/bitproto/tree/master/benchmark/unix>`_."
 msgstr ""
 "你可以在 `github 上查看 unix 系统上详细的压测结果 "
 "<https://github.com/hit9/bitproto/tree/master/benchmark/unix>`_ 。"
 
-#: ../../performance.rst:28 53cb6681f3e5430d86f7dee3dab2281a
+#: ../../performance.rst:28 8c22d25bf93b44978c0ca033bec69f41
 msgid "Embedded"
 msgstr "嵌入式"
 
-#: ../../performance.rst:30 156b14e4d2224a9380afe6281009074b
+#: ../../performance.rst:30 6f00958b202142c99ed0d1e6a98e1894
 msgid ""
 "I have tested the benchmark on a `stm32 board "
 "<https://www.st.com/content/st_com/en/products/microcontrollers-"
@@ -85,19 +85,19 @@ msgstr ""
 "cortex-m3 72MHz cpu) 上进行了压测测试， 一次编码调用或者解码调用占用 ``160 μs`` 左右的时间，并且可以通过 "
 ":ref:`优化模式 <performance-optimization-mode>` 来降低到 ``9 μs`` 左右。"
 
-#: ../../performance.rst:34 2d3fd08418c3476f8d3657f35fccfebd
+#: ../../performance.rst:34 a7e21c83a62444128647cd7eb165dc76
 msgid ""
 "You can checkout `the detail benchmark results for stm32 on github "
 "<https://github.com/hit9/bitproto/tree/master/benchmark/stm32>`_."
 msgstr ""
 "你可以在 `github 上查看 stm32 上详细的压测结果 "
 "<https://github.com/hit9/bitproto/tree/master/benchmark/stm32>`_ 。"
 
-#: ../../performance.rst:39 84d37078007e461ca24d471be16638a2
+#: ../../performance.rst:39 ad92d04793de49b2915c8130d15988c3
 msgid "The Optimization Mode"
 msgstr "优化模式"
 
-#: ../../performance.rst:41 579b722162f0420380482f7d023d929b
+#: ../../performance.rst:41 57bf44a750604e3fae7f457d89dc48b1
 msgid ""
 "For most cases, the performance may meet the requirements. But if you are"
 " not satisfied with this, there's still a way to go, the called "
@@ -107,11 +107,11 @@ msgstr ""
 "对于大多数场景，bitproto 的性能应该可以满足需求。但是如果你对此不满意，仍然有一种方法可以尝试，即 bitproto 中所谓的 "
 "\"优化模式\" 。通过给 bitproto 的编译器添加一个 选项 ``-O`` ， 可以开启优化模式："
 
-#: ../../performance.rst:49 e6579dadd3994b5bbe3e6966f878f9db
+#: ../../performance.rst:49 d1c0c280dc8145ebb3e3ec81efabb674
 msgid "By this way, bitproto will generate code for you in optimization mode."
 msgstr "这样，bitproto 会生成优化模式下的代码。"
 
-#: ../../performance.rst:51 3ffa6b66bdeb475297d7d52c539ddaa6
+#: ../../performance.rst:51 b03ab717d6214c84a2df771923ecffcb
 msgid ""
 "The mechanism behind optimization mode is to generate plain "
 "encoding/decoding code statements directly at code-generation time. We "
@@ -124,7 +124,7 @@ msgstr ""
 "中所有的类型都是定长的，因此在代码生成阶段是完全可以知道如何对数据进行编解码的。在代码生成阶段，bitproto "
 "会遍历消息的所有字段然后生成比特拷贝的语句。"
 
-#: ../../performance.rst:58 43fa73b31d03496c9ae5f06278874c43
+#: ../../performance.rst:58 b7b6978f1d6d4c9887c17b8e370307ab
 msgid ""
 "The optimization mode doesn't work for :ref:`extensible messages "
 "<language-guide-extensibility>`. Because extensible messages decoding "
@@ -133,13 +133,13 @@ msgstr ""
 "优化模式不支持和 :ref:`扩展性消息 <language-guide-extensibility>` "
 "一起工作。因为扩展性消息的解码需要依赖动态的计算。"
 
-#: ../../performance.rst:61 c6c8996c2e6b455bb50adcf2ffd4b5cf
+#: ../../performance.rst:61 a4f55d31f811438c8417a8a87b159d62
 msgid ""
 "For an instance in C, the generated code in optimization mode looks like "
 "this:"
 msgstr "以 C 语言举例，优化模式下生成的代码是这个样子的："
 
-#: ../../performance.rst:77 0b94d30b8e6049c989eac7f57fbd693a
+#: ../../performance.rst:77 cc338bc7531c4c429bae6c30973fa54e
 msgid ""
 "See the generated code example above, there's no loops, no if-else, all "
 "statements are plain bit operations. In this way, bitproto's optimization"
@@ -148,7 +148,7 @@ msgstr ""
 "上面的生成代码中，没有循环语句、没有 if-else 语句，所有的语句都是直白的比特操作。通过这种方式，bitproto "
 "的优化模式可以给我编解码效率上最大化的提升。"
 
-#: ../../performance.rst:80 1b357537ecac420e99b7dd218150a394
+#: ../../performance.rst:80 decfd75d51194b67b48e476beeaf8cb2
 msgid ""
 "It's fine of course to use optimization mode on one end and non-"
 "optimization mode (the standard mode) on another end in message "
@@ -159,7 +159,7 @@ msgstr ""
 "对于通信双方中，一方使用无优化模式 "
 "(标准模式)，一方使用优化模式，这种情况也是没有问题的。优化模式只改变了编码函数和解码函数的编写方式，并没有改变数据的交换格式。"
 
-#: ../../performance.rst:84 0aab94a0796948d88186ff783a525f86
+#: ../../performance.rst:84 1479eef78e9041ff833a31815438440c
 msgid ""
 "In fact, using the optimization mode is also a trade-off sometimes. In "
 "this mode, we have to drop the benefits of :ref:`extensibility <language-"
@@ -173,23 +173,23 @@ msgstr ""
 "extensibility>` "
 "，这样其实对协议的兼容性设计是不友好的。优化模式是为了性能敏感的场景设计的，比如低功耗的嵌入式板，计算密集的微控制器。在以下场景下，推荐使用优化模式："
 
-#: ../../performance.rst:89 30f46c8635cc4f189aa7ae85963d7f1c
+#: ../../performance.rst:89 e5289a76f06c4079b9457a2f18bdd6f1
 msgid ""
 "Performance-sensitive scenarios, where ``100μs`` means totally different "
 "with ``10μs``."
 msgstr "性能敏感的场景，``100μs`` 和 ``10μs`` 完全不是一回事。"
 
-#: ../../performance.rst:90 6276e2c7c9574bffa74573391de9735b
+#: ../../performance.rst:90 93d2930a06d8474eb1fc5cd8552611fb
 msgid ""
 "The firmwares of communication ends are always upgraded together, thus "
 "the backward-compatibility is not so important."
 msgstr "通信相关方的固件升级总是一起进行的，这样向后兼容性就不那么重要了。"
 
-#: ../../performance.rst:91 9953ef6e28d9446eb636044f4cbc4c93
+#: ../../performance.rst:91 d5cdd86545854648a25d6f7c417062b0
 msgid "Firmware updates are not frequent, even only once for a long time."
 msgstr "固件的升级并不会频繁，甚至很长时间一次。"
 
-#: ../../performance.rst:93 731df8dd4b0b4f4abe36ec6e5de6d3fb
+#: ../../performance.rst:93 50a0919ac7a740c6a54e25e4fbd024d9
 #, python-format
 msgid ""
 "Specially, for the scenario that firmware-upgrading of communication ends"
@@ -203,51 +203,53 @@ msgstr ""
 "<https://en.wikipedia.org/wiki/Client%E2%80%93server_model>`_ "
 "，我还是推荐坚持使用标准模式，而不是优化模式。"
 
-#: ../../performance.rst:97 a190f2c6a02e4d1c81a261381b6b51da
+#: ../../performance.rst:97 1d7d5d2606b742dcbebac52661bc688f
 msgid ""
 "The optimization mode is currently supported for language C and Go, (not "
 "yet Python)."
 msgstr "目前，bitproto 的优化模式只支持 C 语言和 Go 语言，目前还不支持 Python 。"
 
-#: ../../performance.rst:99 b16cf3f8c36a49a0b6010693b23e120c
+#: ../../performance.rst:99 19b64ae69eb546c7b1f01eb2ced8a0f7
+#, fuzzy
 msgid ""
 "Another benefit of optimization mode is that the bitproto libraries are "
 "no longer required to be dropped in. The bitproto compiler in "
 "optimization mode already throws out the final encoding and decoding "
 "statements, so the bitproto libraries aren't required. The libraries are "
-"designed to used with standard mode, where protocol extensibility is a "
+"designed to use with standard mode, where protocol extensibility is a "
 "feature."
-msgstr "优化模式所带来的另一个好处是不必在使用支持库了。因为 bitproto 的编译器在优化模式下已经生成了最终的编解码语句，"
-"因此 bitproto 的支持库就不需要了。这些支持库最初的设计是为了支持标准模式下的协议扩展性能力。"
+msgstr ""
+"优化模式所带来的另一个好处是不必在使用支持库了。因为 bitproto 的编译器在优化模式下已经生成了最终的编解码语句，因此 bitproto "
+"的支持库就不需要了。这些支持库最初的设计是为了支持标准模式下的协议扩展性能力。"
 
-#: ../../performance.rst:105 44c905a9afb344ee859b5fd5e72837cc
+#: ../../performance.rst:105 1d316c89fa5f472d84f7a20d58b8fde1
 msgid "Smaller Code Size"
 msgstr "更小的代码量"
 
-#: ../../performance.rst:107 f6916a6fa4394efba918e44564a3e3ff
+#: ../../performance.rst:107 f34ab763057a4b43b0f1bade1afa7381
 msgid ""
 "Embedded firmware may be limited in program size. Bitproto provides "
 "another compiler option ``-F`` to filter messages to generate in "
 "optimization mode:"
 msgstr "嵌入式固件可能受限于编译后程序占用空间的大小。 bitproto 提供了一个编译器选项 ``-F`` 来筛选需要生成编解码函数的消息名字列表："
 
-#: ../../performance.rst:114 3d205ab357e04f8898a9e40f1d21b450
+#: ../../performance.rst:114 fb8416a03ed146c38d4454addc9bd8e7
 msgid ""
 "The command above tells bitproto only to generate encoder and decoder "
 "functions for message ``Packet``, other messages's encoder and decoder "
 "functions will be skpped without generating."
-msgstr "上面的命令中， bitproto 会只生成消息 ``Packet`` 的编码函数和解码函数，"
-"其他消息的编码函数和解码函数则会跳过，不再生成。"
+msgstr "上面的命令中， bitproto 会只生成消息 ``Packet`` 的编码函数和解码函数，其他消息的编码函数和解码函数则会跳过，不再生成。"
 
-#: ../../performance.rst:117 42db4299999f440fa8b367d603a2bb80
+#: ../../performance.rst:117 01faf066ac364b6c8acf36119c102aa1
 msgid ""
 "The ``-F`` trick is useful because in most scenarios we just exchange a "
 "single \"top-level\" bitproto message in communication. This option can "
 "also be used with multiple message names:"
-msgstr "``-F`` 选项之所以是有用处的，是因为在很多情况下，我们在通信过程中只交换一个\"顶级的\"消息。"
-"这个选项也可以用来筛选多个消息名字，使用逗号分隔即可："
+msgstr ""
+"``-F`` "
+"选项之所以是有用处的，是因为在很多情况下，我们在通信过程中只交换一个\"顶级的\"消息。这个选项也可以用来筛选多个消息名字，使用逗号分隔即可："
 
-#: ../../performance.rst:124 a323b26bc7ad41b9b044a3b0a321a8b5
+#: ../../performance.rst:124 a86a675b7f454c49a77bb95f14710eed
 msgid ""
 "Finally to note that, the ``-F`` option can be only used together with "
 "option ``-O``."