From d5075fc76f5d0a7689807e46cfa522292b848533 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=BE=9D=E7=91=AA=E8=B2=93?= Date: Sun, 7 Feb 2021 22:58:17 +0800 Subject: [PATCH] Replaced the messy GNU-styled documents with a single Markdown README.md. --- INSTALL | 145 ------------------------------------- README | 43 ----------- README.md | 210 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ TODO | 5 -- 4 files changed, 210 insertions(+), 193 deletions(-) delete mode 100644 INSTALL delete mode 100644 README create mode 100644 README.md delete mode 100644 TODO diff --git a/INSTALL b/INSTALL deleted file mode 100644 index 105d5b8..0000000 --- a/INSTALL +++ /dev/null @@ -1,145 +0,0 @@ -Acme-GuessNumber Installation Guide - -* Table of Contents - - * System Requirements - * Installation Instruction - ** Install with ExtUtils::MakeMaker - ** Install with Module::Build - ** Install with the CPAN Shell - ** Install with the CPANPLUS Shell - - -* System Requirements - - 1. Perl, version 5 or above. To be a winner of the game you have -no option but Perl 5. You can 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 install/upgrade it from Perl website. - -http://www.perl.com/ - - If you are using MS-Windows, you can download and install -ActiveState ActivePerl. - -http://www.activestate.com/ - - 2. Required Perl modules: None. - - 3. Optional Perl modules: none - - -* Installation Instruction - -** Install with ExtUtils::MakeMaker - - arclog uses standard Perl installation with ExtUtils::MakeMaker. -Follow these steps: - - % perl Makefile.PL - % make - % make test - % make install - - When running make install, make sure you have the priviledge to -write to the installation location. This usually requires the root -priviledge. - - If you are using ActivePerl under MS-Windows, you should use -nmake instead of make. nmake can be obtained from the Microsoft FTP -site. - -ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe - - If you want to install into another location, you can set the -PREFIX. For example, to install into your home when you are not -root: - - % perl Makefile.PL PREFIX=/home/jessica - - Refer to the docuemntation of ExtUtils::MakeMaker for more -installation options (by running perldoc ExtUtils::MakeMaker). - - -** Install with Module::Build - - You can install with Module::Build instead, if you prefer. -Follow these steps: - - % perl Build.PL - % ./Build - % ./Build test - % ./Build install - - When running ./Build install, make sure you have the priviledge to -write to the installation location. This usually requires the root -priviledge. - - If you want to install into another location, you can set the ---prefix. For example, to install into your home when you are not -root: - - % perl Build.PL --prefix=/home/jessica - - Refer to the docuemntation of Module::Build for more -installation options (by running perldoc Module::Build). - - -** Install with the CPAN Shell - - You can install with the CPAN shell, if you prefer. CPAN shell -takes care of ExtUtils::MakeMaker and Module::Build for you: - - % cpan Acme::GuessNumber - - Make sure you have the priviledge to write to the installation -location. This usually requires the root priviledge. Since CPAN -shell 1.81 you can set "make_install_make_command" and -"mbuild_install_build_command" in your CPAN configuration to switch -to root just before install: - - % cpan - cpan> o conf make_install_make_command "sudo make" - cpan> o conf mbuild_install_build_command "sudo ./Build" - cpan> install Acme::GuessNumber - - If you want to install into another location, you can set the -"makepl_arg" and "mbuild_arg" in your CPAN configuration. For -example, to install into your home when you are not root: - - % cpan - cpan> o conf makepl_arg "PREFIX=/home/jessica" - cpan> o conf mbuild_arg "--prefix=/home/jessica" - cpan> install Acme::GuessNumber - - Refer to the docuemntation of cpan for more CPAN shell commands -(by running perldoc cpan). - - -** Install with the CPANPLUS Shell - - You can install with the CPANPLUS shell, if you prefer. CPANPLUS -shell takes care of ExtUtils::MakeMaker and Module::Build for you: - - % cpanp -i Acme::GuessNumber - - Make sure you have the priviledge to write to the installation -location. This usually requires the root priviledge. - - If you want to install into another location, you can set the -"makemakerflags" and "buildflags" in your CPANPLUS configuration. -For example, to install into your home when you are not root: - - % cpanp - CPAN Terminal> s conf makemakerflags "PREFIX=/home/jessica" - CPAN Terminal> s conf buildflags "--prefix=/home/jessica" - CPAN Terminal> install Acme::GuessNumber - - Refer to the docuemntation of cpanp for more CPANPLUS shell -commands (by running perldoc cpanp). - - -imacat -2008-04-22 -imacat@mail.imacat.idv.tw -http://www.imacat.idv.tw/ diff --git a/README b/README deleted file mode 100644 index fde2627..0000000 --- a/README +++ /dev/null @@ -1,43 +0,0 @@ -Acme-GuessNumber - Automatic number guessing game robot - -Many people have this experience: You sit before a gambling table. You -keep placing the bet. You know the Goddess will finally smile at you. -You just don't know when. You have only to wait. As the time goes by, -the bets in your hand become fewer and fewer. You feel the time goes -slower and slower. This lengthy waiting process become painfully long, -like a train running straightforwardly into hell. You start feeling -your whole life is a failure, as the jackpot never comes... - -But, hey, why so painfully waiting? The Goddess will finally smile at -you, right? So, why not put this painly waiting process to a computer -program? Yes. This is the whole idea, the greatest invention in the -century:: An automatic gambler! There is no secret. It is simple -brute force. It never-endingly runs toward the final jackpot. You can -go for other business: sleep, eat, work. When you finally came back you -wins. With it, the hell of gambling is history! - -Remember, that the computer is never affected by emotion, luck, -everything. It never feel anxious or depress. It simply, faithfully, -determinedly runs the probability until the jackpot. As you know, -the anxiety and depression is the enemy of the games, while a -simple, faithful and determined mind is the only path to the jackpot. -This makes computer a perfect candidate as a gambler than an ordinary -human. - - -* Installation - - Read INSTALL for instructions on how to install -Locale::Maketext::Gettext. - - -* News, Changes and Updates - - Refer to the Changes for changes, bug fixes, updates, new functions, etc. - - -* Copyright - -Copyright (c) 2007-2008 imacat. All rights reserved. This program is free -software; you can redistribute it and/or modify it under the same terms -as Perl itself. diff --git a/README.md b/README.md new file mode 100644 index 0000000..7e3086b --- /dev/null +++ b/README.md @@ -0,0 +1,210 @@ +Acme-GuessNumber - Automatic number guessing game robot +======================================================= + +Many people have this experience: You sit before a gambling table. +You keep placing the bet. You know the Goddess will finally smile at +you. You just don't know when. You have only to wait. As the time +goes by, the bets in your hand become fewer and fewer. You feel the +time goes slower and slower. This lengthy waiting process become +painfully long, like a train running straightforwardly into hell. You +start feeling your whole life is a failure, as the jackpot never +comes... + +Hey, why so painfully waiting? The Goddess always smile at you in the +end, right? So, why not put this painfully waiting process to a +computer program? Yes. This is the whole idea, the greatest +invention in the century:: An automatic gambler! There is no secret. +It is simple brute force. It endlessly runs toward the final prize. +You can go for other business: sleep, eat, work. When you finally +came back, you wins. With it, the hell of gambling is history! + +Remember, that the computer is never affected by emotion, luck, +everything. It never gets anxious or depress. It simply, faithfully, +determinedly runs the probability until the jackpot. As you know, +the anxiety and depression is the enemy of the games, while a +simple, faithful and determined mind is the only path to the jackpot. +This makes computer a perfect candidate as a gambler than an ordinary +human being. + + + +System Requirements +------------------- + +1. Perl, version 5.8.0 or above. To be a winner of the game you have + no option but Perl 5. You can 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 install/upgrade it from the + [Perl website]. If you are using MS-Windows, you can download and + install [ActiveState ActivePerl]. + +2. Required Perl modules: None. + +3. Optional Perl modules: None. + +[Perl website]: https://www.perl.org +[ActiveState ActivePerl]: https://www.activestate.com + + +Download +-------- + +Acme::GuessNumber is hosted is on… + +* [Acme-GuessNumber on GitHub] + +* [Acme-GuessNumber on MetaCPAN] + +[Acme-GuessNumber on GitHub]: https://github.com/imacat/Acme-GuessNumber +[Acme-GuessNumber on MetaCPAN]: https://metacpan.org/release/Acme-GuessNumber + + +Install +------- + +### Install with [ExtUtils::MakeMaker] + +Acme-GuessNumber uses standard Perl installation with +ExtUtils::MakeMaker. Follow these steps: + + % perl Makefile.PL + % make + % make test + % make install + +When running `make install`, make sure you have the privilege to write +to the installation location. This usually requires the `root` +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 +`PREFIX`. For example, to install into your home when you are not +`root`: + + % perl Makefile.PL PREFIX=/home/jessica + +Refer to the documentation of ExtUtils::MakeMaker for more +installation options (by running `perldoc ExtUtils::MakeMaker`). + + +### Install with [Module::Build] + +You can install with Module::Build instead, if you prefer. Follow +these steps: + + % perl Build.PL + % ./Build + % ./Build test + % ./Build install + +When running `./Build install`, make sure you have the privilege to +write to the installation location. This usually requires the `root` +privilege. + +If you want to install into another location, you can set the +`--prefix`. For example, to install into your home when you are not +``root``: + + % perl Build.PL --prefix=/home/jessica + +Refer to the documentation of Module::Build for more +installation options (by running `perldoc Module::Build`). + + +### Install with the CPAN Shell + +You can install with the CPAN shell, if you prefer. CPAN shell +takes care of ExtUtils::MakeMaker and Module::Build for you: + + % cpan Acme::GuessNumber + +Make sure you have the privilege to write to the installation +location. This usually requires the `root` privilege. Since CPAN +shell 1.81 you can set `make_install_make_command` and +`mbuild_install_build_command` in your CPAN configuration to switch +to `root` just before install: + + % cpan + cpan> o conf make_install_make_command "sudo make" + cpan> o conf mbuild_install_build_command "sudo ./Build" + cpan> install Acme::GuessNumber + +If you want to install into another location, you can set `makepl_arg` +and `mbuild_arg` in your CPAN configuration. For example, to install +into your home when you are not `root`: + + % cpan + cpan> o conf makepl_arg "PREFIX=/home/jessica" + cpan> o conf mbuild_arg "--prefix=/home/jessica" + cpan> install Acme::GuessNumber + +Refer to the documentation of cpan for more CPAN shell commands +(by running `perldoc cpan`). + + +### Install with the CPANPLUS Shell + +You can install with the CPANPLUS shell, if you prefer. CPANPLUS +shell takes care of ExtUtils::MakeMaker and Module::Build for you: + + % cpanp -i Acme::GuessNumber + +Make sure you have the privilege to write to the installation +location. This usually requires the `root` privilege. + +If you want to install into another location, you can set +`makemakerflags` and `buildflags` in your CPANPLUS configuration. +For example, to install into your home when you are not `root`: + + % cpanp + CPAN Terminal> s conf makemakerflags "PREFIX=/home/jessica" + CPAN Terminal> s conf buildflags "--prefix=/home/jessica" + CPAN Terminal> install Acme::GuessNumber + +Refer to the documentation of `cpanp` for more CPANPLUS shell +commands (by running `perldoc cpanp`). + +[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 + + +Source +------ + +Source is now on Github. See +https://github.com/imacat/Acme-GuessNumber. + + +Bugs +---- + +No. This can't possibly be wrong. This is brute-force. It will try +until it succeeds. Nothing can stop it from success. You always win! +You will always win! The Goddess of fortune will always smile at you! + + +News, Changes and Updates +------------------------- + +Refer to the Changes for changes, bug fixes, updates, new functions, +etc. + + +To Do +----- + +* Add the prizes for the game winners, of course. + +* Add the worldwide ranking for the top 10 winners through internet + connection. + + +Copyright +--------- + + Copyright (c) 2007-2021 imacat. All rights reserved. This program is free + software; you can redistribute it and/or modify it under the same terms + as Perl itself. diff --git a/TODO b/TODO deleted file mode 100644 index 9900270..0000000 --- a/TODO +++ /dev/null @@ -1,5 +0,0 @@ -Acme-GuessNumber TODO list - -- Add the jackpots for the game winners, of course. -- Add the worldwide ranking for the top 10 winners through internet - connection.