summaryrefslogtreecommitdiffstatshomepage
path: root/docs/source/initialsetup
Commit message (Collapse)AuthorAgeFilesLines
* Micscellaneous cleanup/fixes: Vas Crabb2022-04-301-10/+13
| | | | | | | | | | | | | | | | machine/z80scc.cpp: Fixed a cast-to-bool that broke detection of changes to one register bit. formats/fsmeta.cpp: Use visitors with variants where it makes sense. docs: Updated minimum required SDL version to 2.0.6 for all targets, added note that Python 3 is included with Xcode and updated instructions for downloading stand-alone Python 3 for macOS. ksys573.cpp: Don't create an insane number of textures for fghtmn and pnchman internal artwork. Tidied another batch of slot machine layouts.
* docs: List MSYS2 packages required to build PDF documentation on Windows now ↵ Vas Crabb2022-01-121-2/+11
| | | | that TeX Live is available.
* Fix build with newer versions of Emscripten; minimum supported version is ↵ Justin Kerk2021-12-231-2/+2
| | | | now 2.0.25.
* Overdue internal UI enhancements (#8674) Vas Crabb2021-10-091-17/+24
| | | | | | | | | | | | | | | | * frontend: Added support for message context to localisations. * frontend: Added string_view versions of the message lookup functions. * frontend: Added a few more folder options to the internal UI. * emu/softlist.cpp: Use more appropriate containers. * Switched to Python 3 by default - this will become a requirement. * Updated msgfmt.py for message context support. * frontend: Show all software item info in the internal UI. * frontend: Search alternate titles in software selection menu. * 3rdparty/utf8proc: Updated to v2.6.1 (has several fixes). * frontend: Added software filters for common info fields. * frontend: Allow UI manager to hold onto persistent session data. * frontend: Cache software lists for eight machines. * frontend: Added support for loading localised system names. * frontend: Add UI for selecting localised system names.
* Remove leftover mame64 from docs Olivier Galibert2021-05-251-16/+10
|
* Docmumentation update/expansion. [Firehawke, Vas Crabb] Vas Crabb2021-05-075-68/+248
|
* docs: Update build requirements for Ubuntu (#8010) algestam2021-04-281-1/+1
|
* docs: Update build requirements for Fedora - someone should do this for ↵ Vas Crabb2021-04-251-1/+1
| | | | other distros.
* Updated compiling document to reflect that MSVC 2019 is working and recommended. Stiletto2021-04-161-6/+3
| | | | | Source Changes -------------- Updated compiling document to reflect that MSVC 2019 is working and recommended.
* Suggested changes to MacOS to build reqs (#7715) mac-a-r0ni2021-01-291-17/+6
| | | | | | Update compilingmame.rst * Changes in macOS section regarding current build requirements * Added basic info for Apple Silicon to macOS build instructions.
* Change "mame64" to "mame" in docs (#7709) Firehawke2021-01-291-1/+1
|
* -docs update: Vas Crabb2021-01-231-84/+159
| | | | | | | | | | | | | | | * Added note explaining that view options saved in machine CFG take precedence over INI/command line. * Added prerequisites for building HTML documentation under MSYS2 and Fedora Linux. * Explicitly mentioned that Ubuntu modifies GCC to enable "fortify source" by default in the relevant section. * Removed obsolete reference to glibstdc++6. * Re-formated compiling guide source (hard wrap at 80 columns, typographical quotes, code blocks for sample command lines). -genie.lua: Show GCC ignored attribute warnings, but don't fail for them.
* -Switch to building MAME as C++17. Vas Crabb2020-11-151-4/+4
| | | | | | | * Updated sol2 to 3.2.2 * Updated pugixml to 1.10 * Increased minimum clang version to 6 * Cleaned up some stuff that can use new features
* -hp3478a.cpp: Made LCD segments dark in internal artwork. Vas Crabb2020-11-041-6/+5
| | | | -Fixed another batch of MSVC errors resolving overloaded operators.
* -General maintenance on emu/devfind: Vas Crabb2020-11-041-0/+67
| | | | | | | | | | | | * Harmonised memory region/share finder/creator APIs. * Moved .found() to optional object finders. * Added truth test operator to optional object finders. * Fixed things that were testing .found() on required object finders. * Improved Doxygen API documentation. -dec8.cpp: Moved csilver to its own state class. -docs: Added some notes about setting up and using MSYS2.
* docs: Add links to some internal layouts that demonstrate various features, ↵ Vas Crabb2020-10-281-2/+3
| | | | and udpate required MSYS64 packages for using lld.
* emu/video: check macros are defined before doing comparisons, also fix a ↵ Vas Crabb2020-08-211-1/+1
| | | | typo in docs
* docs: update for changes in MSYS2 packages, fix a typo, add note about using ↵ Vas Crabb2020-08-211-6/+21
| | | | LLVM linker with GCC
* (nw) fix MPU4 video crash, clean up a little Vas Crabb2019-10-271-1/+1
|
* Make devdelegate more like devcb for configuration. This is a Vas Crabb2019-10-261-15/+35
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fundamental change to show device delegates are configured. Device delegates are now aware of the current device during configuration and will resolve string tags relative to it. This means that device delegates need a device to be supplied on construction so they can find the machine configuration object. There's a one-dimensional array helper to make it easier to construct arrays of device delegates with the same owner. (I didn't make an n-dimensional one because I didn't hit a use case, but it would be a simple addition.) There's no more bind_relative_to member - just call resolve() like you would for a devcb. There's also no need to cast nullptr when creating a late bind device delegate. The flip side is that for an overloaded or non-capturing lambda you'll need to cast to the desired type. There is one less conditional branch in the hot path for calls for delegates bound to a function pointer of member function pointer. This comes at the cost of one additional unconditional branch in the hot path for calls to delegates bound to functoids (lambdas, functions that don't take an object reference, other callable objects). This applies to all delegates, not just device delegates. Address spaces will now print an error message if a late bind error is encountered while installing a handler. This will give the range and address range, hopefully making it easier to guess which memory map is faulty. For the simple case of allowing a device_delegate member to be configured, use a member like this: template <typename... T> void set_foo(T &&...args) { m_foo_cb.set(std::forward<T>(args)...); } For a case where different delegates need to be used depending on the function signature, see src/emu/screen.h (the screen update function setters). Device delegates now take a target specification and function pointer. The target may be: * Target omitted, implying the current device being configured. This can only be used during configuration. It will work as long as the current device is not removed/replaced. * A tag string relative to the current device being configured. This can only be used during configuration. It will not be callable until .resolve() is called. It will work as long as the current device is not removed/replaced. * A device finder (required_device/optional_device). The delegate will late bind to the current target of the device finder. It will not be callable until .resolve() is called. It will work properly if the target device is replaced, as long as the device finder's base object isn't removed/replaced. * A reference to an object. It will be callable immediately. It will work as long as the target object is not removed/replaced. The target types and restrictions are pretty similar to what you already have on object finders and devcb, so it shouldn't cause any surprises. Note that dereferencing a device finder will changes the effect. To illustrate this: ... required_device<some_device> m_dev; ... m_dev(*this, "dev") ... // will late bind to "dev" relative to *this // will work if "dev" hasn't been created yet or is replaced later // won't work if *this is removed/replaced // won't be callable until resolve() is called cb1.set(m_dev, FUNC(some_device::w)); ... // will bind to current target of m_dev // will not work if m_dev is not resolved // will not work if "dev" is replaced later // will be callable immediately cb2.set(*m_dev, FUNC(some_device::w)); ... The order of the target and name has been reversed for functoids (lambdas and other callable objects). This allows the NAME macro to be used on lambdas and functoids. For example: foo.set_something(NAME([this] (u8 data) { m_something = data; })); I realise the diagnostic messages get ugly if you use NAME on a large lambda. You can still give a literal name, you just have to place it after the lambda rather than before. This is uglier, but it's intentional. I'm trying to drive developers away from a certain style. While it's nice that you can put half the driver code in the memory map, it detracts from readability. It's hard to visualise the memory range mappings if the memory map functions are punctuated by large lambdas. There's also slightly higher overhead for calling a delegate bound to a functoid. If the code is prettier for trivial lambdas but uglier for non-trivial lambdas in address maps, it will hopefully steer people away from putting non-trivial lambdas in memory maps. There were some devices that were converted from using plain delegates without adding bind_relative_to calls. I fixed some of them (e.g. LaserDisc) but I probably missed some. These will likely crash on unresolved delegate calls. There are some devices that reset delegates at configuration complete or start time, preventing them from being set up during configuration (e.g. src/devices/video/ppu2c0x.cpp and src/devices/machine/68307.cpp). This goes against the design principles of how device delegates should be used, but I didn't change them because I don't trust myself to find all the places they're used. I've definitely broken some stuff with this (I know about asterix), so report issues and bear with me until I get it all fixed.
* New working software list additions (#5772) Firehawke2019-10-231-0/+21
| | | | | | | | | * New working software list additions ----------------------------------- apple2_flop_orig: Gauntlet, Go (Hayden), Ghostbusters, Galactic Wars, Guderian [4am, Firehawke] * Add details on compiling MAME documentation. (nw)
* (nw) Fedora users need this now that X11 XInput is enabled by default - no ↵ Vas Crabb2019-04-261-1/+1
| | | | clue about other Linuxes
* doc: add python to list of required ubuntu packages (nw) Henrik Algestam2019-04-231-1/+1
|
* (nw) Clean up the mess on master Vas Crabb2019-03-261-17/+110
| | | | | | | | | | | | | This effectively reverts b380514764cf857469bae61c11143a19f79a74c5 and c24473ddff715ecec2e258a6eb38960cf8c8e98e, restoring the state at 598cd5227223c3b04ca31f0dbc1981256d9ea3ff. Before pushing, please check that what you're about to push is sane. Check your local commit log and ensure there isn't anything out-of-place before pushing to mainline. When things like this happen, it wastes everyone's time. I really don't need this in a week when real work™ is busting my balls and I'm behind where I want to be with preparing for MAME release.
* Revert "conflict resolution (nw)" andreasnaive2019-03-251-110/+17
| | | | | This reverts commit c24473ddff715ecec2e258a6eb38960cf8c8e98e, reversing changes made to 009cba4fb8102102168ef32870892438327f3705.
* (nw) omission, formatting Vas Crabb2019-02-181-2/+2
|
* (nw) misc stuff: Vas Crabb2019-02-181-3/+32
| | | | | | * Document cross-compilation options * Use lowercase for some libraries that are lowercase in system32 on Windows anyway * Make USE_BUNDLED_LIB_SDL2=0 not use the bundled SDL
* update docs (nw) Vas Crabb2019-01-281-2/+2
|
* Doc: Minor fix (nw) (#4547) algestam2019-01-221-2/+2
|
* Correct compilation packages (for #4507) and finish cleanup on previous docs ↵ Firehawke2019-01-131-2/+2
| | | | | | | | updates. (nw) (#4509) * Correct the compilation packages [partial for #4507] (nw) * Minor corrections, joymap adjustments (nw)
* better documentation for compiling on Windows (nw) Vas Crabb2019-01-121-9/+73
|
* Case sensitivity training for INI (nw) (#4455) Firehawke2019-01-031-2/+2
| | | | | | | | | | | | | | | | | | | | * Case sensitivity training for INI (nw) The world is not 100% Windows, so case sensitvity is needed. * Further standardization of the formatting (nw) More to go... * Pass 2 of new formatting wave (nw) More to go, though. * wave 3 of formatting cleanup (nw) Further adjustments and cleanups, including unwanted tabs. * Correct filtering instructions (nw)
* additional documentation on compiling MAME (nw) Vas Crabb2019-01-011-1/+268
|
* cherry-pick fixes from mainline and clean up some stuff (nw) Vas Crabb2018-07-231-1/+1
|
* allow repeating elements and groups - useful if you need e.g. a lot of ↵ Vas Crabb2018-07-221-1/+1
| | | | numbered labels, but it limits complay.py's ability to check for invalid references as it can't evaluate expressions (nw)
* Better Emscripten parameter handling, & update docs (nw) Justin Kerk2018-07-211-0/+3
|
* note required Emscripten version (nw) Vas Crabb2018-02-251-1/+1
|
* Updated Fedora instructions Brian King2017-07-041-1/+1
| | | DNF is now preferred package manager. alsa-lib-devel is also required (not mentioned in the current docs)
* srcclean again (nw) Vas Crabb2016-11-303-11/+11
|
* Added documentation to main tree (nw) Miodrag Milanovic2016-08-244-0/+226