aboutsummaryrefslogtreecommitdiffstats
path: root/source/language.rst
Commit message (Collapse)AuthorAgeFilesLines
* Redo appearance of top-level docs and pages.Marti Bolivar2011-10-081-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is a fairly significant set of changes, aimed at improving the overall usability of the documentation. Add source/_templates/indexcontent.html, which is a Jinja template used to generate index.html. This mimics the Python docs' style of having a short, styled table as main index interface. We're doing this because people keep missing the board hardware pages that are below the fold. Hopefully this will make them (and other important pages) easier to find. The new file source/_static/index-style.css controls the presentation of the generated index.html. Move the contents of source/index.rst to source/contents.rst, and increase the toctree depths to 2. This increase has the ancillary benefit that secondary headers within the current page are displayed in the sidebar, which should aid navigation within the page. contents.rst is meant to be a contents in full, where users who know what they're looking for can go. The "Table of Contents" link on the sidebar points here. Add a new source/_static/leaflabs-docs.css. It's currently unused, but is the place where people should put CSS that wants to override the defaults. Modify source/_templates/layout.html to include aforementioned leaflabs-docs.css. Also tweak the behavior of the rootrellink block, which provides the breadcrumbs in page headers and footers. Change the titles of various top-level docs so they can be referenced from the toctrees in contents.rst directly. Having two names (one in the contents, one at the top of the page) has got to be confusing people. Make an exception for FAQ so that it appears in one line on the sidebar. Adjust conf.py to reflect all of these changes. Also: - Fix "Lucidia" -> "Lucida" typo - Get rid of intersphinx_mapping (we don't use it, and including it makes it impossible to build the docs offline). - Remove the logo from sidebar; it's big and ugly and serves no purpose. Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
* language.rst: Improvements for C and C++ programmers.Marti Bolivar2011-09-211-17/+10
| | | | | | | | | | Improve the "Looking for Something Else" escape hatches, so people who aren't looking for Wiring can get where they're going more easily. Fix and improve the Note for C/C++ hackers. Remove the note about dynamic memory; that works now. Other tweaks. Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
* language: Making atoi() question point to FAQ.Marti Bolivar2011-06-141-9/+4
|
* language.rst: Tweaks for C/C++ hackers.Marti Bolivar2011-06-131-1/+3
|
* Docs: move ASSERT() to its own page.Marti Bolivar2011-06-101-42/+11
| | | | | ASSERT() was previously documented in language.rst. Move it to a new lang/api/assert.rst.
* 0.0.10 Documentation checkpoint.Marti Bolivar2011-04-261-28/+37
| | | | | | | | | | | | | | The vast majority of the Maple-specific values have been pulled out of the higher-level overview pages and replaced with refs into documents under /docs/source/hardware/. Much of the work that's left to be done in this regard is labeled with versioned TODO and FIXME comments. Suggestions from StephenFromNYC and gbulmer were incorporated from this forum thread: http://forums.leaflabs.com/topic.php?id=703
* 0.0.10 documentation checkpoint.Marti Bolivar2011-04-251-33/+44
| | | | | Merging in the standalone refactor docs, etc. The individual libmaple API pages are going to need to get redone.
* Board-specific values; corresponding QA test generalizations.Marti Bolivar2011-03-301-14/+32
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Various board-specific #defines and arrays of pins added. For the changelog (some of this information predates this commit): * wirish/boards.h now declares the following arrays of pin numbers: * boardPWMPins - PWM-capable pins * boardADCPins - ADC-capable pins * boardUsedPins - pins already in use, e.g. BOARD_BUTTON_PIN It also declares a bool boardUsesPin(uint8 pin) function for convenient testing of whether a pin is in use. * wirish/boards/*.h now define: * BOARD_USART1_TX_PIN * BOARD_USART1_RX_PIN * BOARD_USART2_TX_PIN * BOARD_USART2_RX_PIN * BOARD_USART3_TX_PIN * BOARD_USART3_RX_PIN * BOARD_NR_GPIO_PINS (renamed from NR_GPIO_PINS) * BOARD_NR_USARTS (renamed from NR_USARTS) * BOARD_NR_PWM_PINS * BOARD_NR_ADC_PINS * BOARD_NR_USED_PINS * wirish/boards/maple_native.h now defines: * BOARD_UART4_TX_PIN * BOARD_UART4_RX_PIN * BOARD_UART5_TX_PIN * BOARD_UART5_RX_PIN (Unfortunately, wirish/boards/maple_RET6.h cannot, since at least one of the UART4/UART5 pins are used already; this will require layout changes for a wide-release Maple form factor RET6 board). * wirish/boards/*.cpp all include the corresponding array definitions. They all live in flash by default, thanks to the new __FLASH__ macro in wirish/wirish_types.h, which is a synonym for the existing __attr_flash #define in libmaple/libmaple_types.h. The documentation was updated to include this information. It also gained various FIXME/TODO comments related to its generalization across boards. The quality assurance-related examples (examples/qa-slave-shield.cpp and examples/test-session.cpp) now make heavy use of board-specific values to ensure portability.
* shiftOut(), docs fixesMarti Bolivar2011-03-111-4/+5
|
* Cleaned out libmaple.h; this had wide-ranging implications.Marti Bolivar2011-02-271-30/+27
| | | | | | | | | | | | | | | | | | | Many of the #defines in libmaple.h were board-specific, not MCU-specific. Most of these were only used by code under libmaple/usb/. These were moved into usb_config.h, and are clearly marked as being terrible hacks. I'm going to treat the USB stack as a black box that we'll deal with later. Further, instead of having a variety of #defines like "How many USARTS do I have?", we decide that based on the density of the chip. This is determined by testing for STM32_MEDIUM_DENSITY or STM32_HIGH_DENSITY defines. libmaple currently doesn't support low-density chips, so that suffices. The Makefile will set these automatically based on the MCU. Other offending #defines are ERROR_LED_PORT and ERROR_LED_PIN; these were made optional, but they're set in the Makefile as a hack to keep things working.
* Fixed docs bug where we say "long" when we mean "long long"Marti Bolivar2011-02-091-37/+37
|
* Finalized 0.0.9 documentation.Marti Bolivar2010-12-151-118/+115
|
* docs, now with styleHanna Mendes Levitin2010-12-011-2/+8
|
* New documentation content is done. Next step is to theme.Marti Bolivar2010-11-291-2/+14
|
* Finished converting the Arduino docsMarti Bolivar2010-11-291-99/+105
|
* reorganized all the arduino/ docs into a lang/ subdirectory sinceMarti Bolivar2010-11-281-160/+160
| | | | they're properly CC attributed now.
* updated serial bootloader spec; other improvementsMarti Bolivar2010-11-211-268/+201
|
* arduino language reference nearing completion, properly CC-BY-SA 3.0 attributedMarti Bolivar2010-11-171-3/+5
|
* docsMarti Bolivar2010-10-221-6/+4
|
* initial check-in of arduino docs in RST format (converted using wget+pandoc)Marti Bolivar2010-10-201-8/+5
|
* more sphinx docsMarti Bolivar2010-10-111-3/+7
|
* more docsMarti Bolivar2010-10-111-47/+6
|
* docsMarti Bolivar2010-10-111-3/+1
|
* current Maple documentation either rewritten or stubbed out in SphinxMarti Bolivar2010-10-081-49/+80
|
* lots more docsMarti Bolivar2010-10-071-9/+172
|
* language referenceMarti Bolivar2010-10-071-9/+9
|
* language referenceMarti Bolivar2010-10-071-8/+9
|
* language referenceMarti Bolivar2010-10-071-39/+290
|
* some comment stubsMarti Bolivar2010-10-071-0/+86