To build Angband using Microsoft's Visual Studio.

 1. Download the source from the homepage at http://rephial.org or clone the
    git repostitory at https://github.com/angband/angband.

 2. Make an empty win32 project in visual studio.

 3. Extract/copy the source code into the project directory. Make sure that 
    the src directory is in the project directory, rather than in another
    subdirectory.

 4. Copy libpng.dll and zlib1.dll from src\win\dll\ to the project directory.

 5. In the project settings, in the C/C++ tab, in the additional include
    directories line, add: src, src/win, src/win/include.

 6. In the project settings, in the Link tab, in the Object/library modules
    line, add: "src\win\zlib1.lib src\win\libpng.lib msimg32.lib winmm.lib "
    to the front of the line.

 7. In the project settings, also in the Link tab, remove any directory names
    (usually Debug\ or Release\) from in front of the executable name. Doing
    this will put the executeable in the project directory so you do not have
    to move it every time the project is compiled.

 8. Add all of the files that end in ".c" or ".h" in the src directory EXCEPT
    those that have "main" in their name and snd-sdl.c to the project files.
    This can be done by right-clicking on the project in visual studio and 
    choosing "Add Files to Project" from the context menu or by going to
    "Project" -> "Add to Project" -> "Files" from the menu bar.

 9. Add all of the files that end in ".c" or ".h" in the src\win directory
    to the project, as well as angband.rc.

10. Add main-win.c from the src directory to the project.

11. (optional) To include sound support, open the project's "Property Pages"
    dialog box.  In the left pane, select "Configuration Properties, C/C++,
    Preprocessor".  In the right pane of the "Preprocessor Definitions"
    property, open the drop-down menu and choose "Edit".  In the "Preprocessor
    Definitions" dialog box, add a line containing "SOUND" (without the quotes;
    a semicolon may be necessary after "SOUND" to separate it from the other
    definitions).  If you want to build the borg, include "ALLOW_BORG"
    (without the quotes; as with "SOUND" a semicolon may be necessary to
    separate it from the other definitions) in the preprocessor definitions.
    To build the borg, you will also have to add all the files that end in
    ".c" or ".h" in the src\borg directory to the project.  To suppress some
    warning about standard C library and Unix-compatibility functions, you
    may want to add "_CRT_SECURE_NO_WARNINGS" (without the quotes) to the
    preprocessor definitions.

12. Save the project, then compile the project. There will be a lot of
    warnings, but there should not be any errors. The warnings can be ignored.

13. If there are no errors, enjoy playing angband. There should not be any
    errors and the executable should be built. If there are any errors, and
    you do not know how to fix them, you can ask on the forums at
    https://angband.live/forums/ or in the #angband-dev IRC channel on libera.chat.

14. Report bugs or request changes on https://github.com/angband/angband/issues
    at the Github site or on the forums at https://angband.live/forums/ .

15. To submit bug fixes, changes, etc please open pull requests on the Github
    site.
