Skip to content

Sync with CPython 3.10 #182

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Dec 20, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
99 changes: 55 additions & 44 deletions distutils/sourcedist.po
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.10\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-06-20 18:08+0800\n"
"POT-Creation-Date: 2021-12-18 00:09+0000\n"
"PO-Revision-Date: 2018-05-23 14:09+0000\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
Expand Down Expand Up @@ -97,6 +97,11 @@ msgstr "``bztar``"
msgid "bzip2'ed tar file (:file:`.tar.bz2`)"
msgstr ""

#: ../../distutils/sourcedist.rst:34 ../../distutils/sourcedist.rst:37
#: ../../distutils/sourcedist.rst:43
msgid "\\(5)"
msgstr "\\(5)"

#: ../../distutils/sourcedist.rst:37
msgid "``xztar``"
msgstr "``xztar``"
Expand All @@ -114,8 +119,8 @@ msgid "compressed tar file (:file:`.tar.Z`)"
msgstr ""

#: ../../distutils/sourcedist.rst:40
msgid "\\(4)"
msgstr "\\(4)"
msgid "(4),(5)"
msgstr "(4),(5)"

#: ../../distutils/sourcedist.rst:43
msgid "``tar``"
Expand Down Expand Up @@ -155,71 +160,77 @@ msgstr ""

#: ../../distutils/sourcedist.rst:65
msgid ""
"deprecated by `PEP 527 <https://www.python.org/dev/peps/pep-0527/>`_; `PyPI "
"<https://pypi.org>`_ only accepts ``.zip`` and ``.tar.gz`` files."
msgstr ""

#: ../../distutils/sourcedist.rst:68
msgid ""
"When using any ``tar`` format (``gztar``, ``bztar``, ``xztar``, ``ztar`` or "
"``tar``), under Unix you can specify the ``owner`` and ``group`` names that "
"will be set for each member of the archive."
msgstr ""

#: ../../distutils/sourcedist.rst:69
#: ../../distutils/sourcedist.rst:72
msgid "For example, if you want all files of the archive to be owned by root::"
msgstr ""

#: ../../distutils/sourcedist.rst:77
#: ../../distutils/sourcedist.rst:80
msgid "Specifying the files to distribute"
msgstr ""

#: ../../distutils/sourcedist.rst:79
#: ../../distutils/sourcedist.rst:82
msgid ""
"If you don't supply an explicit list of files (or instructions on how to "
"generate one), the :command:`sdist` command puts a minimal default set into "
"the source distribution:"
msgstr ""

#: ../../distutils/sourcedist.rst:83
#: ../../distutils/sourcedist.rst:86
msgid ""
"all Python source files implied by the ``py_modules`` and ``packages`` "
"options"
msgstr ""

#: ../../distutils/sourcedist.rst:86
#: ../../distutils/sourcedist.rst:89
msgid ""
"all C source files mentioned in the ``ext_modules`` or ``libraries`` options"
msgstr ""

#: ../../distutils/sourcedist.rst:92
#: ../../distutils/sourcedist.rst:95
msgid ""
"scripts identified by the ``scripts`` option See :ref:`distutils-installing-"
"scripts`."
msgstr ""

#: ../../distutils/sourcedist.rst:95
#: ../../distutils/sourcedist.rst:98
msgid ""
"anything that looks like a test script: :file:`test/test\\*.py` (currently, "
"the Distutils don't do anything with test scripts except include them in "
"source distributions, but in the future there will be a standard for testing "
"Python module distributions)"
msgstr ""

#: ../../distutils/sourcedist.rst:100
#: ../../distutils/sourcedist.rst:103
msgid ""
"Any of the standard README files (:file:`README`, :file:`README.txt`, or :"
"file:`README.rst`), :file:`setup.py` (or whatever you called your setup "
"script), and :file:`setup.cfg`."
msgstr ""

#: ../../distutils/sourcedist.rst:104
#: ../../distutils/sourcedist.rst:107
msgid ""
"all files that matches the ``package_data`` metadata. See :ref:`distutils-"
"installing-package-data`."
msgstr ""

#: ../../distutils/sourcedist.rst:107
#: ../../distutils/sourcedist.rst:110
msgid ""
"all files that matches the ``data_files`` metadata. See :ref:`distutils-"
"additional-files`."
msgstr ""

#: ../../distutils/sourcedist.rst:110
#: ../../distutils/sourcedist.rst:113
msgid ""
"Sometimes this is enough, but usually you will want to specify additional "
"files to distribute. The typical way to do this is to write a *manifest "
Expand All @@ -231,46 +242,46 @@ msgid ""
"filesystem."
msgstr ""

#: ../../distutils/sourcedist.rst:118
#: ../../distutils/sourcedist.rst:121
msgid ""
"If you prefer to roll your own manifest file, the format is simple: one "
"filename per line, regular files (or symlinks to them) only. If you do "
"supply your own :file:`MANIFEST`, you must specify everything: the default "
"set of files described above does not apply in this case."
msgstr ""

#: ../../distutils/sourcedist.rst:123
#: ../../distutils/sourcedist.rst:126
msgid ""
"An existing generated :file:`MANIFEST` will be regenerated without :command:"
"`sdist` comparing its modification time to the one of :file:`MANIFEST.in` "
"or :file:`setup.py`."
msgstr ""

#: ../../distutils/sourcedist.rst:128
#: ../../distutils/sourcedist.rst:131
msgid ""
":file:`MANIFEST` files start with a comment indicating they are generated. "
"Files without this comment are not overwritten or removed."
msgstr ""

#: ../../distutils/sourcedist.rst:132
#: ../../distutils/sourcedist.rst:135
msgid ""
":command:`sdist` will read a :file:`MANIFEST` file if no :file:`MANIFEST.in` "
"exists, like it used to do."
msgstr ""

#: ../../distutils/sourcedist.rst:136
#: ../../distutils/sourcedist.rst:139
msgid ""
":file:`README.rst` is now included in the list of distutils standard READMEs."
msgstr ""

#: ../../distutils/sourcedist.rst:140
#: ../../distutils/sourcedist.rst:143
msgid ""
"The manifest template has one command per line, where each command specifies "
"a set of files to include or exclude from the source distribution. For an "
"example, again we turn to the Distutils' own manifest template:"
msgstr ""

#: ../../distutils/sourcedist.rst:150
#: ../../distutils/sourcedist.rst:153
msgid ""
"The meanings should be fairly clear: include all files in the distribution "
"root matching :file:`\\*.txt`, all files anywhere under the :file:`examples` "
Expand All @@ -283,7 +294,7 @@ msgid ""
"language; see section :ref:`sdist-cmd`."
msgstr ""

#: ../../distutils/sourcedist.rst:160
#: ../../distutils/sourcedist.rst:163
msgid ""
"The order of commands in the manifest template matters: initially, we have "
"the list of default files as described above, and each command in the "
Expand All @@ -292,137 +303,137 @@ msgid ""
"in the source distribution:"
msgstr ""

#: ../../distutils/sourcedist.rst:166
#: ../../distutils/sourcedist.rst:169
msgid "all files in the Distutils \"build\" tree (default :file:`build/`)"
msgstr ""

#: ../../distutils/sourcedist.rst:168
#: ../../distutils/sourcedist.rst:171
msgid ""
"all files in directories named :file:`RCS`, :file:`CVS`, :file:`.svn`, :file:"
"`.hg`, :file:`.git`, :file:`.bzr` or :file:`_darcs`"
msgstr ""

#: ../../distutils/sourcedist.rst:171
#: ../../distutils/sourcedist.rst:174
msgid ""
"Now we have our complete list of files, which is written to the manifest for "
"future reference, and then used to build the source distribution archive(s)."
msgstr ""

#: ../../distutils/sourcedist.rst:174
#: ../../distutils/sourcedist.rst:177
msgid ""
"You can disable the default set of included files with the :option:`!--no-"
"defaults` option, and you can disable the standard exclude set with :option:"
"`!--no-prune`."
msgstr ""

#: ../../distutils/sourcedist.rst:178
#: ../../distutils/sourcedist.rst:181
msgid ""
"Following the Distutils' own manifest template, let's trace how the :command:"
"`sdist` command builds the list of files to include in the Distutils source "
"distribution:"
msgstr ""

#: ../../distutils/sourcedist.rst:182
#: ../../distutils/sourcedist.rst:185
msgid ""
"include all Python source files in the :file:`distutils` and :file:"
"`distutils/command` subdirectories (because packages corresponding to those "
"two directories were mentioned in the ``packages`` option in the setup "
"script---see section :ref:`setup-script`)"
msgstr ""

#: ../../distutils/sourcedist.rst:187
#: ../../distutils/sourcedist.rst:190
msgid ""
"include :file:`README.txt`, :file:`setup.py`, and :file:`setup.cfg` "
"(standard files)"
msgstr ""

#: ../../distutils/sourcedist.rst:190
#: ../../distutils/sourcedist.rst:193
msgid "include :file:`test/test\\*.py` (standard files)"
msgstr ""

#: ../../distutils/sourcedist.rst:192
#: ../../distutils/sourcedist.rst:195
msgid ""
"include :file:`\\*.txt` in the distribution root (this will find :file:"
"`README.txt` a second time, but such redundancies are weeded out later)"
msgstr ""

#: ../../distutils/sourcedist.rst:195
#: ../../distutils/sourcedist.rst:198
msgid ""
"include anything matching :file:`\\*.txt` or :file:`\\*.py` in the sub-tree "
"under :file:`examples`,"
msgstr ""

#: ../../distutils/sourcedist.rst:198
#: ../../distutils/sourcedist.rst:201
msgid ""
"exclude all files in the sub-trees starting at directories matching :file:"
"`examples/sample?/build`\\ ---this may exclude files included by the "
"previous two steps, so it's important that the ``prune`` command in the "
"manifest template comes after the ``recursive-include`` command"
msgstr ""

#: ../../distutils/sourcedist.rst:203
#: ../../distutils/sourcedist.rst:206
msgid ""
"exclude the entire :file:`build` tree, and any :file:`RCS`, :file:`CVS`, :"
"file:`.svn`, :file:`.hg`, :file:`.git`, :file:`.bzr` and :file:`_darcs` "
"directories"
msgstr ""

#: ../../distutils/sourcedist.rst:207
#: ../../distutils/sourcedist.rst:210
msgid ""
"Just like in the setup script, file and directory names in the manifest "
"template should always be slash-separated; the Distutils will take care of "
"converting them to the standard representation on your platform. That way, "
"the manifest template is portable across operating systems."
msgstr ""

#: ../../distutils/sourcedist.rst:216
#: ../../distutils/sourcedist.rst:219
msgid "Manifest-related options"
msgstr ""

#: ../../distutils/sourcedist.rst:218
#: ../../distutils/sourcedist.rst:221
msgid ""
"The normal course of operations for the :command:`sdist` command is as "
"follows:"
msgstr ""

#: ../../distutils/sourcedist.rst:220
#: ../../distutils/sourcedist.rst:223
msgid ""
"if the manifest file (:file:`MANIFEST` by default) exists and the first line "
"does not have a comment indicating it is generated from :file:`MANIFEST.in`, "
"then it is used as is, unaltered"
msgstr ""

#: ../../distutils/sourcedist.rst:224
#: ../../distutils/sourcedist.rst:227
msgid ""
"if the manifest file doesn't exist or has been previously automatically "
"generated, read :file:`MANIFEST.in` and create the manifest"
msgstr ""

#: ../../distutils/sourcedist.rst:227
#: ../../distutils/sourcedist.rst:230
msgid ""
"if neither :file:`MANIFEST` nor :file:`MANIFEST.in` exist, create a manifest "
"with just the default file set"
msgstr ""

#: ../../distutils/sourcedist.rst:230
#: ../../distutils/sourcedist.rst:233
msgid ""
"use the list of files now in :file:`MANIFEST` (either just generated or read "
"in) to create the source distribution archive(s)"
msgstr ""

#: ../../distutils/sourcedist.rst:233
#: ../../distutils/sourcedist.rst:236
msgid ""
"There are a couple of options that modify this behaviour. First, use the :"
"option:`!--no-defaults` and :option:`!--no-prune` to disable the standard "
"\"include\" and \"exclude\" sets."
msgstr ""

#: ../../distutils/sourcedist.rst:237
#: ../../distutils/sourcedist.rst:240
msgid ""
"Second, you might just want to (re)generate the manifest, but not create a "
"source distribution::"
msgstr ""

#: ../../distutils/sourcedist.rst:242
#: ../../distutils/sourcedist.rst:245
msgid ":option:`!-o` is a shortcut for :option:`!--manifest-only`."
msgstr ""
Loading