1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[DOC] Tweaks for windows.md

Browse Source
This commit is contained in:
Nobuyoshi Nakada 2024-10-28 21:38:57 +09:00
parent 4f467c3fbf
commit 90ef28f59b
No known key found for this signature in database
GPG Key ID: 3582D74E1FEE4465
1 changed files with 22 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
doc/windows.md
View File

@ -72,16 +72,16 @@ make
**Note** building ruby requires following commands. **Note** building ruby requires following commands.
* nmake * `nmake`
* cl * `cl`
* ml * `ml`
* lib * `lib`
* dumpbin * `dumpbin`
4. If you want to build from GIT source, following commands are required. 4. If you want to build from GIT source, following commands are required.
* git * `git`
* sed * `sed`
* ruby 3.0 or later * `ruby` 3.0 or later
You can use [scoop](https://scoop.sh/) to install them like: You can use [scoop](https://scoop.sh/) to install them like:
@ -104,21 +104,23 @@ make
1. Execute `win32\configure.bat` on your build directory. 1. Execute `win32\configure.bat` on your build directory.
You can specify the target platform as an argument. You can specify the target platform as an argument.
For example, run `configure --target=i686-mswin32` For example, run `configure --target=i686-mswin32`.
You can also specify the install directory. You can also specify the install directory.
For example, run `configure --prefix=<install_directory>` For example, run `configure --prefix=<install_directory>`.
Default of the install directory is `/usr` . Default of the install directory is `/usr` .
2. If you want to change the name of the executable files and the DLL 2. If you want to append to the executable and DLL file names,
file, you can specify `--program-prefix` and `--program-suffix`, specify `--program-prefix` and `--program-suffix`, like
like `win32\configure.bat --program-suffix=-$(MAJOR)$(MINOR)`. `win32\configure.bat --program-suffix=-$(MAJOR)$(MINOR)`.
Also `--install-name` and `--so-name` options affect the whole Also, the `--install-name` and `--so-name` options specify the
name executable files and the DLL file respectively, like exact base names of the executable and DLL files, respectively,
`win32\configure.bat --install-name=$(RUBY_BASE_NAME)-$(MAJOR)$(MINOR)`. like `win32\configure.bat --install-name=$(RUBY_BASE_NAME)-$(MAJOR)$(MINOR)`.
And add _RUBYW_INSTALL_NAME_ to change the name of the By default, the name for the executable without a console window
executable without console window if also you want. is generated from the _RUBY_INSTALL_NAME_ specified as above by
replacing `ruby` with `rubyw`. If you want to make it different
more, modify _RUBYW_INSTALL_NAME_ directly in the Makefile.
3. You need specify vcpkg directory to use `--with-opt-dir` 3. You need specify vcpkg directory to use `--with-opt-dir`
option like `win32\configure.bat --with-opt-dir=vcpkg_installed\x64-windows` option like `win32\configure.bat --with-opt-dir=vcpkg_installed\x64-windows`
@ -127,8 +129,8 @@ make
5. Run `nmake` 5. Run `nmake`
6. Run `nmake prepare-vcpkg` if you need to copy 6. Run `nmake prepare-vcpkg` if you need to copy vcpkg installed
vcpkg installed libraries like `libssl-3-x64.dll` to the build directory. libraries like `libssl-3-x64.dll` to the build directory.
7. Run `nmake check` 7. Run `nmake check`