[MacPorts] howto/Mame modified

[MacPorts Wiki]

Page "howto/Mame" was changed by ryandesign
Diff URL: <https://trac.macports.org/wiki/howto/Mame?action=diff&version=12>
Revision 12
Comment: Edits for clarity, spelling, capitalization
Changes:
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: howto/Mame
=========================================================================
--- howto/Mame (version: 11)
+++ howto/Mame (version: 12)
@@ -1,8 +1,5 @@
-= About Mame
-Mame is an open source emulator built to recreate the hardware of old arcade games on your modern computer. The main focus is on documenting the old hardware and the heritage of old arcade games in order to avoid the will be forgotten. To get further informations on the project, you can check [https://docs.mamedev.org/ here] the documentation.
-
-== Macports
-On macports the availabe port to install MAME is `mame`. Generally we try to stay in track with the last release upstream.
+= MAME
+MAME is an open source emulator built to recreate the hardware of old arcade games on your modern computer. The main focus is on documenting the old hardware and the heritage of old arcade games in order to avoid that they will be forgotten. To get further information on the project, you can check [https://docs.mamedev.org the documentation].
 
 == Installing MAME
 {{{
@@ -10,60 +7,52 @@
 }}}
 
 == Configuring MAME
-Once the port successfully installed, what you're going to have is an executable called `mame`. Now, to be able to run the ROMs, we need to build the right filesystem tree in a directory. What I generally do is to create a directory in the root of my home, called, very originally, `mame`.
+Once the port is successfully installed, you'll have an executable called `mame`. To be able to run the ROMs, you need to build the right filesystem tree in a directory. What I generally do is to create a directory in my home directory called `mame`:
 
 {{{ 
 mkdir ~/mame
 }}}
 
-Now if you go inside that directory
+Go inside that directory:
 
 {{{
 cd ~/mame
 }}}
 
-and you run the `mame` executable inside of it. MAME will run full screen and it will create a folder inside of `~/mame`  called `cfg`. That is the folder where MAME stores the configuration files. In the MAME initial dashboard you won't see much for the moment...
+and run the `mame` executable inside of it. MAME will run full screen and it will create a folder inside of `~/mame`  called `cfg`. That is the folder where MAME stores the configuration files. In the MAME initial dashboard you won't see much for the moment...
 
 [[Image(mame-dash.png)]]
 
-Let's try to put something to play with :). Generally, to play the most famous titles, you'll need a specific BIOS, i.e. a proprietary set of instructions that are specific of a certain hardware. For example, to run NeoGeo games, you'll need the last release of the NeoGeo BIOS whose file is called `neogeo.zip`. The problem with this kind of BIOSes is that in general they're under copyright and you're not allowed to run them. So to start, we'll try to use one of the ROMs offered on the [https://www.mamedev.org/roms/ official dev website of MAME]. As you can see they're free for non-commercial use.
+Let's add a game to the list. Generally, to play the most famous titles, you'll need a specific BIOS, i.e. a proprietary set of instructions that are specific to a certain hardware. For example, to run NeoGeo games, you'll need the last release of the NeoGeo BIOS whose file is called `neogeo.zip`. The problem with these kinds of BIOSes is that in general they're under copyright and you're not allowed to run them. So to start, we'll try to use one of the ROMs offered on the [https://www.mamedev.org/roms/ official dev website of MAME]. They're free for non-commercial use.
 
-So... let's try [https://www.mamedev.org/roms/alienar Alien Arena], looks promising:  
+Let's try [https://www.mamedev.org/roms/alienar/ Alien Arena].
 
- Alien Arena was developed by Duncan Brown in 1984 to run on the classic Williams hardware. It is a "capture the flag" style game with a number of interesting twists. It was even put on location, but, well, Duncan explains all this in his readme. Here's an excerpt of the history:
- By 1984, I had reverse-engineered the hardware used in Williams' games to the point where I had essentially created a "programmer's guide" for it. Destiny called, I had to write a new game from scratch for this great hardware! My original intent was to end up with a conversion kit that was more user-friendly than most (remember this was back when conversions were just starting to come into existence, long before JAMMA, and most of them were a complete mess to install). A new marquee, new side stickers, new control panel, and 12 EPROMs, and away you go! No messy wiring, board modifications, etc. My production costs would be low, my sale price could be high.
+== Running a ROM
 
- Well, that was the plan anyway...
-
- Over the course of a year, I wrote "Alien Arena". It was written in 6809 assembly language using a cross-compiler on an Apple II+. Using custom-designed and handbuilt emulator hardware (*24* 2Kx8 static RAMs on a board connected to the Apple with a custom bus interface!) I could test out my code without the slowdown of programming and erasing a bunch of EPROMs all the time.
-
- When I was done, I assembled it into an ex-Stargate cabinet, and put it out in the arcade I owned at the time. I made a few modifications (mostly to the computer-player AI) based on feedback from customers. I cannot say it was an immense hit. Most people thought it sucked, frankly. You decide for yourself. I know my wife and I had a blast playing it while I was designing it (probably added 6 months to the time to finish it, heh heh heh...).
-
-=== Running a ROM
-
-* First thing is to download the ROM of the game `alienar.zip`.
-* Then let's create the folder that will store our roms `mkdir ~/mame/roms`.
-* Let's move the Alien Arean roms inside this directory: `mv ~/Downloads/alienar.zip ~/mame/roms`
-* Let's run `mame` within the `~/mame` directory.
+* First download the ROM of the game `alienar.zip`.
+* Then create the folder that will store our ROMs: `mkdir ~/mame/roms`.
+* Then move the Alien Arean ROMs inside this directory: `mv ~/Downloads/alienar.zip ~/mame/roms`
+* Then run `mame` within the `~/mame` directory.
 
 [[Image(mame-alien-arena.png)]]
 
-As you can see we finally have the game. Let's try to run it pressing '''Enter'''!l
+As you can see we finally have the game. Let's try to run it by pressing '''Enter'''.
 
 [[Image(mame-alien-start.png)]]
 
-We are in the initial splash screen of the game. Cool! To actually start the game, you need to insert coins. In order to do that, you have to use the keyboard key (5) or (6) (the numbers) to add coins for the 1st or 2nd player respectively. Then you can use the keyboard arrows to move around, and the keys (control) and (option) correspond to the first two buttons of the arcade cabinet. You can find further information on the keys [https://docs.mamedev.org/usingmame/defaultkeys.html here].
+We are in the initial splash screen of the game. Cool! To actually start the game, you need to insert coins. In order to do that, you have to use keyboard keys `5` or `6` to add coins for the 1st or 2nd player respectively. Then you can use the keyboard arrows to move around, and the keys `control` and `option` correspond to the first two buttons of the arcade cabinet. You can find further information on the keys [https://docs.mamedev.org/usingmame/defaultkeys.html here].
 
 [[Image(mame-alien-play.png)]]
 
-=== Adding more material to a ROM
-Ok, now we can play the game. But that's not everything. We clearly would like to have original artworks and a cool snapshots of the game such that we can see from the MAME dashboard which game are we navigating into. Where do we find them? There are several website, my favourite one is [http://www.progettosnaps.net/index.php Progetto-Snaps]. It was born to provide snapshots, but nowadays you can find whatever resource you want and you can download them in bulk.
+== Adding more material to a ROM
+You can add original artwork and screen snapshots of the game such that you can see from the MAME dashboard which game you are navigating into. There are several websites offering such files, one of which is [https://www.progettosnaps.net/index.php Progetto-Snaps]. It was born to provide snapshots, but nowadays you can find whatever resource you want and you can download them in bulk.
 
-We'll instead use my ugly screenshot just above. So you take that image, you rename it with the same name of the game ROM, in our case `alienar.png`, and you put it in the folder `snap` (create it before!) within our root folder `mame`. 
+We'll instead use my ugly screenshot just above. Take that image, rename it with the same name of the game ROM—in our case `alienar.png`—and put it in the folder `snap` (create it first) within our root folder `mame`. 
 {{{
+mkdir ~/mame/snap
 mv alienar.png ~/mame/snap
 }}}
 
-And... tadah! You know have the snapshot in your MAME dashboard.
+And now have the snapshot in your MAME dashboard.
 
-There's more to add, like the artworks (In the `artwork` folder). I'll let you explore a bit on that to configure your MAME installation as you wish!  [http://easyemu.mameworld.info/mameguide/getting_started/folders_and_files.html Here] you can find more informations about all the directory tree and what you can add.
+There's more to add, like the artwork (in the `artwork` folder). You can explore and configure your MAME installation as you wish. [https://easyemu.mameworld.info/mameguide/getting_started/folders_and_files.html Here] you can find more information about the directory tree and what all you can add.
-------8<------8<------8<------8<------8<------8<------8<------8<--------

--
Page URL: <https://trac.macports.org/wiki/howto/Mame>
MacPorts <https://www.macports.org/>
Ports system for macOS

This is an automated message. Someone added your email address to be
notified of changes on 'howto/Mame' page.
If it was not you, please report to admin at macports.org.