Commit Graph

453 Commits

Author SHA1 Message Date
L.S. Cook 3f4c347f35 doc: Cleanup prefix table on naming_conventions.rst
Table updated with examples column to eliminate Latin prefixes (e.g.) and
to enhance readability.

W/S fixed

Change-Id: Ia92e2d5454e816595e054cb44caa56364f9dc1b3
Signed-off-by: L.S. Cook <leonax.cook@intel.com>
2016-02-17 06:38:56 +00:00
L.S. Cook 7c2a12f6a5 doc: Edit arduino_101.rst for spelling, grammar, consistency
Minor ReST syntax and consistency errors fixed.

Change-Id: Ia53ffc3303d1fb75dc513ae1d7f53301d8c874e3
Signed-off-by: L.S. Cook <leonax.cook@intel.com>
2016-02-17 00:06:55 +00:00
Dan Kalowsky 59f305ed85 docs : setting up LF account
Breaking out the documentation on setting up a Linux Foundation account to
it's own section.  This isn't needed for the getting started process, and is
only needed if someone decides to start contributing code.

Change-Id: I112b65a53b167927d2617aef7364c13f30f74c33
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-16 11:04:04 -08:00
Dan Kalowsky 40781ac1d0 docs : setting_up : allow anonymous downloads
The current doc structure requires the creation of a Linux Foundation
account, which is not really a valid open source usage model.  In fact,
it isn't even required to download anything as anonymous git clone works.

Content on creating a Linux Foundation ID will be moved to the
collaboration section in another commit.

Change-Id: I50253d7b3da85b64986d62f2e5bee25da3eb3987
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-16 09:59:54 -08:00
Rodrigo Caballero 77d1e04a7f doc: Fix minor grammar error on getting_started.rst
Change-Id: Ifdd6527d37098edd233ef6a152541419e1708fad
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-16 17:05:04 +00:00
Mariusz Skamra 8ca1826bde Bluetooth: doc: Add L2CAP PICS file
This adds Implementation Conformance Statement (ICS) for L2CAP layer
with currently supported features.

Change-Id: Ie15d2936877edb674e20283b12a50487df5cdc02
Signed-off-by: Mariusz Skamra <mariusz.skamra@tieto.com>
2016-02-16 13:50:00 +01:00
Anas Nashif 3320df7949 docs: fixed API linking
Change-Id: If9daa0e11c967ee19684dd9d08438f749abf9d5e
2016-02-16 06:16:48 +00:00
Anas Nashif 9f26ac9961 docs: fixed lists and indent for arduino_101
Change-Id: I07ac843c5244c23671e57c019db57e84540677e0
2016-02-15 15:46:45 +00:00
Anas Nashif bf0ec3b43b docs: fixed indentation in gerrit practices
Align code examples and other parts of the document.

Change-Id: I1f6eb9d5d22991f54e367ed248abfe0d49622cc5
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-14 18:40:35 -05:00
Anas Nashif 93f04f3e15 docs: fixed feature lists for quark_d2000_crb
Change-Id: I1512118189d215340306a34ef63795b960692bf0
2016-02-14 18:40:35 -05:00
Anas Nashif 47b9b4c838 docs: fixed lists and indent for arduino_due
Change-Id: I674bf1d0cab30a83dc28e186c05042c53095337e
2016-02-14 18:40:35 -05:00
Anas Nashif 0b5a8beeb5 docs: fixed lists and indent for galileo
Change-Id: Ia677871e02469f1d529d558310182221124508b7
2016-02-14 18:40:35 -05:00
Anas Nashif 1ab2d24c1a docs: Update information about tree structure
add boards, tests sub-directories to the tree.

Change-Id: I353fd4a4b2b23f7d3a7ca22d42b555ffb1b14ce5
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-14 18:40:35 -05:00
Dan Kalowsky 8b10ed80cd docs : arduino_101 : build steps are incorrect
The build steps as they are written imply that you will always need to
source the zephyr-env.sh file before flashing.  This is not the case.

Change-Id: I2cffd5ee4b190dee8304f1843727926c7467f5ed
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-14 21:59:21 +00:00
Dan Kalowsky 1bf8859550 docs : arduino_101 : fix build command
The make command is broken

Change-Id: Ie7ac4d75941aad9efbbf9c40f9e6358c8b04f28f
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-14 21:58:35 +00:00
Constanza Heath 4c8f28bb37 Updating TinyCrypt v2.0 documentation.
Change-Id: I53ffef8a799a41442c636509a67cca80bb375787
Signed-off-by: Constanza Heath <constanza.m.heath@intel.com>
2016-02-14 03:46:44 +00:00
Dan Kalowsky 5094d8b797 docs : arduino 101 doc update
Some remnants of earlier versions of the document are still visible in
the current version.

Change-Id: Id6d91d4e87dac641e1f1fe2c3e8200ebfb44a888
2016-02-12 16:44:50 +00:00
Dan Kalowsky 11b88eb1f1 docs : arduino_101 rom needs to be in correct location
Correcting the steps for running the loading of the ROM image.

Change-Id: Icdcfe1c5ffb28ba09b5d12ba0cf39ac25d3d166f
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-12 16:43:47 +00:00
Rodrigo Caballero a3edcaa816 doc: Edit the Event Logger APIs
Edit public API details for clarity, grammar, punctuation found
on file event_logger.h

Includes the event logger information in the ReST documentation.
Modifies doxygen.config to include the event logger.

Made consistent use of @retval to document return values.

Used imperative verbs for all @brief descriptions.

Change-Id: I88b8672a527138e2b4f7df4b4b0495a0d871cad3
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-12 01:41:20 +00:00
Rodrigo Caballero 3bda826484 doc: Fix broken link for USB to TTL cable on Arduino 101 doc.
Change-Id: I124e5dd0e23f09ae72ca1422c0a62c73423f64bc
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-11 20:11:35 +00:00
Javier B Perez a5375bd903 doc: install linux: update SDK wget link
Change-Id: I4f6f5570aae0be08c3809a61a1df7cfbaf3efdf1
Signed-off-by: Javier B Perez <javier.b.perez.hernandez@intel.com>
2016-02-11 18:18:09 +00:00
Anas Nashif 47db990d44 doc: fix path to samples after restructering
Change-Id: I0366acd913188ddcdf626b95ff05b8c9c305b777
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-11 13:08:44 -05:00
Aceves 85ec5ff7cc doc: Edit the heading markup
Edited heading markup for consistancy.

Change-Id: Ic91cea28427be92e82f1318821a6eead78467c52
Signed-off-by: Aceves <gerardo.aceves@intel.com>
2016-02-11 01:19:48 +00:00
Rodrigo Caballero 10bea3dec8 doc: Include the I/O APIs in the documentation.
Includes the I/O drivers' interfaces in the ReST documentation.

Change-Id: I9ef70c4b0561c102b5c9425b4e41b5c813bf51b6
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-11 01:04:38 +00:00
Rodrigo Caballero 9a1acd715a doc: Edit the code-block ReST documentation.
Change-Id: I4e38d9ed3cfb0aa50d559a94641c10175142f659
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-11 01:03:57 +00:00
Anas Nashif 3f123c6b6e doc: fixed include path for input directories
Change-Id: Iec71dd19a676bd6a9349a386990034fc7ddd2f85
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-10 03:30:50 +00:00
Anas Nashif fb44466164 doc: create api directory
Change-Id: Iecf09fd9b362f7c1ea25efdc5ac3d2345630766a
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-09 17:15:56 -05:00
Javier B Perez e7cf19bf1e doc: getting started: update SDK location
Change-Id: Iec3f73953c076dab75ae7a54344ad762dc83ac0a
Signed-off-by: Javier B Perez <javier.b.perez.hernandez@intel.com>
2016-02-09 18:11:51 +00:00
Anas Nashif ef61a3e164 doc: simplify supported board page
Remove table which had redundant information and created a simple TOC
with boards. This will allow easy expansion of the list over time.

Change-Id: Ic94063cc99ddcb3d2140a4beef1067a9766d60a3
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-09 18:04:37 +00:00
Anas Nashif df8db31f53 doc: add brief description for Kconfig in the reference
Change-Id: I8ba54feb9d684945177c7ecfb08255aaf796734f
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-09 18:04:36 +00:00
Anas Nashif dfee33269b doxygen: enable uart functions guarded by ifdef
Many of the UART interface functions are hidden behind ifdefs,
set those to 'y' when building documentation.

Change-Id: I1371e64b6fe4c269ce41c2c54e0f013d8088dbcf
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-09 18:04:36 +00:00
Anas Nashif 76bba72b97 trivial: fixed typo: sempahores -> semaphores
Change-Id: Ie119f8478c6a75c6ee8cab6277758b1cab85fcd6
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-09 18:04:36 +00:00
Juan Manuel Cruz ee2b119877 doc: adds the task monitor documentation
Change-Id: I659bc206a636ffc723f3ac72b5b90f9a6ebcc565
Signed-off-by: Juan Manuel Cruz <juan.m.cruz.alcaraz@linux.intel.com>
2016-02-09 13:03:19 -05:00
Genaro Saucedo Tejada 2b8673b571 doc: Linux Foundation registration steps
Updates Set Up steps from previous 01.org Gerrit to new Linux Foundation one.

Change-Id: Iab98864b405ff6dc4ea20d687fae77bd59284678
Signed-off-by: Genaro Saucedo Tejada <genaro.saucedo.tejada@intel.com>
2016-02-08 21:47:33 -05:00
Daniel Leung 9d727d8bdb doc/boards: updates arduino_due for supported features...
... and adds a note about terminal and flashing.

Change-Id: I9b3fe9a8e9993ee68612d177aa4163fcf15e912d
Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2016-02-08 21:45:07 -05:00
Genaro Saucedo Tejada f0a7bf801e doc: Linux Foundation registration steps
Updates Set Up steps from previous 01.org Gerrit to new Linux Foundation one.

Change-Id: Iab98864b405ff6dc4ea20d687fae77bd59284678
Signed-off-by: Genaro Saucedo Tejada <genaro.saucedo.tejada@intel.com>
2016-02-08 20:17:17 -05:00
Javier B Perez 22d0af20c6 doc: gerrit: update gerrit links and screen shots with LF infra
Updated all the links and references for gerrit to the new gerrit
in LF. Also updated the screenshots to show the new gerrit and
project name.

Change-Id: If56b230379fad4de58032f9d729e6a94f27389ed
Signed-off-by: Javier B Perez <javier.b.perez.hernandez@intel.com>
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-08 20:09:05 -05:00
Rodrigo Caballero 26bd7d6b43 doc: Fix headings in master index file.
Search engines recommend having only one heading on level 1.
Modified the headings in the documentation index file to
follow the recommendation and help ensure that search engines
place Zephyr higher on their results lists.

Change-Id: I5590138f88721d1f2cdcbb49ad2aaad1d2dcd466
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-08 16:16:59 -05:00
Genaro Saucedo Tejada 940e34d542 doc: Change 01.org to Linux Foundation
Updates files that were previously referencing the no longer in use
01.org infrastructure, now it we refer Linux Foundation name and have
updated links.

Change-Id: I9d03d7c23f855390f74219dbf1617fde1d58b33b
Signed-off-by: Genaro Saucedo Tejada <genaro.saucedo.tejada@intel.com>
2016-02-08 16:16:59 -05:00
Gerardo Aceves 7c9e4990a2 doc: Fixed consistency issues
Fixed file's reference label.
Fixed cross-reference labels.

Change-Id: Id397aa9a142c692f4e2e552c9bebff626e4692a0
Signed-off-by: Gerardo Aceves <gerardo.aceves@intel.com>
2016-02-08 16:16:59 -05:00
Rodrigo Caballero 776df4adbe doc: Fix headings with the correct level.
Removed a repeated heading and set the ther headings
with the correct level.

Change-Id: Ief8b2f9a7f88d0b6c2456d6ae448e86bb0b8d050
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-08 16:16:59 -05:00
Rodrigo Caballero c0871e4b91 doc: Change link in README to external link.
Changed the link to the ReST documentation to a external link for reusability.

Change-Id: Ia575717c0fb92672828bb11854c9a8a1268af464
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-08 16:16:59 -05:00
Rodrigo Caballero 40df7fcf41 doc: Remove Sphinx markup from README
Removes the Sphinx specific ReST Markup from th README.rst file.
This allows basic ReST converters to render the README without
markup showing raw.

Change-Id: I9f31afb953802119939d177524c0d283414c3a48
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-08 16:16:59 -05:00
Dan Kalowsky ef79b12fcf doc : gerrit : sentence correction
Fixing the minor language issue.

Change-Id: Ic9dd55e2604fde3c30f4bda65668401de037fc4b
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-08 16:16:59 -05:00
Dan Kalowsky 164051f065 doc : gerrit : commit message formats
Adding documentation on best practices for a commit message.

Change-Id: I354fc13f641bc93c8fd82aca6310d488ffc30f24
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-08 16:16:59 -05:00
Dan Kalowsky 58d39653dc doc : gerrit_pracitces : fix line lengths
gerrit_practices.rst has style and formatting issues.  Bringing them back
in line with the recommended practices of the project.

Change-Id: If76406e046ab376cea3e14c0e490e38587b34e6d
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-08 16:16:59 -05:00
L.S. Cook 085acb8ea7 doc: nav for supported boards simplified
Supported platforms section (platforms.rst) renamed to "boards.rst"
and broke into two tables instead of one (x86 arch and ARM arch).
Developer feedback was that navigating for board config options
by board architectures should be made easier.

Also updated index w/TOC to make supported board details
easier to find.

Change-Id: Ic014a720fd33ee685bde5809dc5b9e0622f5e989
Signed-off-by: L.S. Cook <leonax.cook@intel.com>
2016-02-05 20:25:33 -05:00
Dan Kalowsky 08dd836791 board : arduino_101 : fixing flash scripts
Fixing the flash script so that we only have one for the process of writing
out the ROM and the OS images.

Change-Id: I6fc8bd8eee553a17c0036da3ce5b89510f3b57d8
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
2016-02-05 20:25:31 -05:00
Dan Kalowsky eb38faa75b doc : arduino_101 : adding image for JTAG connection
Adding in an image for locating the JTAG connector on the Arduino 101 board,
and a visual pointer towards the JTAG silkscreen dot.

Added figures for the JTAG connector.

Change-Id: I57ed5608bf2f3ded325965ec77142e3376f386ed
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-05 20:25:31 -05:00
Dan Kalowsky 0e053a5f4d doc : arduino_101 : adding serial debug information
Adding in a section for attaching a serial cable, and links for two that we
have found that work for us.  Adding in links to both serial cables.

Added figures of the pins with appropriate callouts.

Change-Id: Ibae64811f1c32f6a8e82be17abbc91df6c53219a
Signed-off-by: Dan Kalowsky <daniel.kalowsky@intel.com>
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-05 20:25:31 -05:00