imacat/Locale-Maketext-Gettext
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Revised README, added Strawberry Perl, replaced the dead link to the outdated NMAKE.EXE with the instruction for the MS-Windows users to use Module::Build instead. NMAKE does not work now anyway.

Browse Source
This commit is contained in:
依瑪貓
2021-02-10 08:01:03 +08:00
parent e2350cd6e9
commit 38c5b94f5e
1 changed files with 21 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
README.md
View File

@@ -45,19 +45,22 @@ like the command-line program `gettext`.
System Requirements System Requirements
------------------- -------------------
1. Perl, version 5.8.0 or above. Locale::Maketext::Gettext uses the 1. Perl, version 5.8.0 or above. Locale::Maketext::Gettext needs the
utf8 text internally that is only available since 5.8.0. You can utf8 text internally that is only available since 5.8.0.
run `perl -v` to see your current Perl version. If you don't have
Perl, or if you have an older version of Perl, you can download and You can run `perl -v` to check your current Perl version. If you
install/upgrade it from the [Perl website]. If you are using do not have Perl, or if you have an older version of Perl, you can
MS-Windows, you can download and install [ActiveState ActivePerl]. download and install/upgrade it from the [Perl website]. For
MS-Windows, you can download and install [Strawberry Perl] or
[ActivePerl].
2. Required Perl modules: None. 2. Required Perl modules: None.
3. Optional Perl modules: None. 3. Optional Perl modules: None.
[Perl website]: https://www.perl.org [Perl website]: https://www.perl.org
[ActiveState ActivePerl]: https://www.activestate.com [Strawberry Perl]: https://strawberryperl.com
[ActivePerl]: https://www.activestate.com/products/perl/
Download Download
@@ -78,21 +81,15 @@ Install
### Install with [ExtUtils::MakeMaker] ### Install with [ExtUtils::MakeMaker]
Locale-Maketext-Gettext uses standard Perl installation with
ExtUtils::MakeMaker. Follow these steps:
% perl Makefile.PL % perl Makefile.PL
% make % make
% make test % make test
% make install % make install
When running `make install`, make sure you have the privilege to write When running `make install`, make sure you have the privilege to write
to the installation location. This usually requires the `root` to the installation locations. This usually requires the `root`
privilege. privilege.
If you are using ActivePerl under MS-Windows, you should use `nmake`
instead of `make`. [nmake can be obtained from the Microsoft FTP site.]
If you want to install into another location, you can set the If you want to install into another location, you can set the
`PREFIX`. For example, to install into your home when you are not `PREFIX`. For example, to install into your home when you are not
`root`: `root`:
@@ -102,19 +99,20 @@ If you want to install into another location, you can set the
Refer to the documentation of ExtUtils::MakeMaker for more Refer to the documentation of ExtUtils::MakeMaker for more
installation options (by running `perldoc ExtUtils::MakeMaker`). installation options (by running `perldoc ExtUtils::MakeMaker`).
For MS-Windows, since `make` is not universally available,
Module::Build is preferred to ExtUtils::MakeMaker. See the
instructions below.
### Install with [Module::Build] ### Install with [Module::Build]
You can install with Module::Build instead, if you prefer. Follow
these steps:
% perl Build.PL % perl Build.PL
% ./Build % ./Build
% ./Build test % ./Build test
% ./Build install % ./Build install
When running `./Build install`, make sure you have the privilege to When running `./Build install`, make sure you have the privilege to
write to the installation location. This usually requires the `root` write to the installation locations. This usually requires the `root`
privilege. privilege.
If you want to install into another location, you can set the If you want to install into another location, you can set the
@@ -129,13 +127,12 @@ installation options (by running `perldoc Module::Build`).
### Install with the CPAN Shell ### Install with the CPAN Shell
You can install with the CPAN shell, if you prefer. CPAN shell CPAN shell takes care of ExtUtils::MakeMaker or Module::Build for you:
takes care of ExtUtils::MakeMaker and Module::Build for you:
% cpan Locale::Maketext::Gettext % cpan Locale::Maketext::Gettext
Make sure you have the privilege to write to the installation Make sure you have the privilege to write to the installation
location. This usually requires the `root` privilege. Since CPAN locations. This usually requires the `root` privilege. Since CPAN
shell 1.81 you can set `make_install_make_command` and shell 1.81 you can set `make_install_make_command` and
`mbuild_install_build_command` in your CPAN configuration to switch `mbuild_install_build_command` in your CPAN configuration to switch
to `root` just before install: to `root` just before install:
@@ -160,13 +157,13 @@ Refer to the documentation of cpan for more CPAN shell commands
### Install with the CPANPLUS Shell ### Install with the CPANPLUS Shell
You can install with the CPANPLUS shell, if you prefer. CPANPLUS CPANPLUS shell takes care of ExtUtils::MakeMaker or Module::Build for
shell takes care of ExtUtils::MakeMaker and Module::Build for you: you:
% cpanp -i Locale::Maketext::Gettext % cpanp -i Locale::Maketext::Gettext
Make sure you have the privilege to write to the installation Make sure you have the privilege to write to the installation
location. This usually requires the `root` privilege. locations. This usually requires the `root` privilege.
If you want to install into another location, you can set If you want to install into another location, you can set
`makemakerflags` and `buildflags` in your CPANPLUS configuration. `makemakerflags` and `buildflags` in your CPANPLUS configuration.
@@ -181,7 +178,6 @@ Refer to the documentation of `cpanp` for more CPANPLUS shell
commands (by running `perldoc cpanp`). commands (by running `perldoc cpanp`).
[ExtUtils::MakeMaker]: https://metacpan.org/release/ExtUtils-MakeMaker [ExtUtils::MakeMaker]: https://metacpan.org/release/ExtUtils-MakeMaker
[nmake can be obtained from the Microsoft FTP site.]: ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe
[Module::Build]: https://metacpan.org/release/Module-Build [Module::Build]: https://metacpan.org/release/Module-Build