Laurens Valk
7423161615
api/robotics: simplify API
...
drop methods that will not be implemented for next release and simplify descriptions of methods that will be implemented.
2020-02-05 16:55:03 +01:00
Laurens Valk
6337b6c451
api/iodevices: Separate Ev3devSensor class
...
This is not just an alias for a LUMPDevice because it works differently. On ev3dev, sensor modes are set using strings.
Also, simplify the introductory text and reasons for using it.
2020-02-03 13:54:18 +01:00
Laurens Valk
2bd149a121
doc/iodevices: reorganize TOC
...
Make the heading levels match the module. No subcategories, but say which devices are available on EV3 only.
2020-02-03 11:35:43 +01:00
Laurens Valk
3e5f552591
api/iodevices: update i2c doc and sample
...
Reflect that we read one byte by default.
By popular request, also allow a second way to send one byte, by specifying a register with no data.
2020-02-03 10:37:32 +01:00
Laurens Valk
ab6b15f047
doc/media: toggle items by category
...
Make it easier to browse the options.
2020-01-29 14:47:03 +01:00
Laurens Valk
e97423da72
doc/motors: hide status getters
...
These are not yet implemented
2020-01-29 13:38:32 +01:00
Laurens Valk
741af5280a
config: ignore only generated images
...
Make sure we can add other images without doing special things.
2020-01-29 12:57:03 +01:00
Laurens Valk
d923f79506
doc/motor: reduce width of commented text
2020-01-28 20:30:42 +01:00
Laurens Valk
6525fbc98a
doc/frames: hide page
...
This won't be needed until support for accelerometers is added.
2020-01-28 20:28:29 +01:00
Laurens Valk
f3003720ee
doc/parameters: hide unused parameters
...
There is no functionality in the release that uses this yet.
2020-01-28 20:23:55 +01:00
Laurens Valk
5363ff5015
doc/motors: hide unfinished sections
...
make it easier to see what is ready for review
2020-01-28 20:23:01 +01:00
Laurens Valk
71ae6825a0
doc/pupdevices: hide non-implemented device/method
2020-01-28 20:12:19 +01:00
Laurens Valk
c55556a598
config: ignore unused import
...
These are not used by classes in the docs, but they are used by Sphinx.
Also, this will be used to let autocomplete know that these modules contain a Motor class.
2020-01-28 18:03:18 +01:00
Laurens Valk
9a3d4f88b6
doc/ev3devices, pupdevices: drop catalog id
...
This will be replaced with a render of the device, included by the RST file, not the docstring.
2020-01-28 18:00:55 +01:00
Laurens Valk
e73945d9c5
doc/ev3devices, pupdevices: do not inherit Motor
...
Just import it. Otherwise, Sphinx does not pick up autoattribute docstrings.
2020-01-28 17:58:54 +01:00
Laurens Valk
4ed787240e
api/builtins: drop motor setting setters
...
this will be done through the control attribute instead
2020-01-28 17:53:11 +01:00
Laurens Valk
6278aeb1b6
doc/builtins: drop simplemotor
...
Now that we have reduced the complexity of the docstrings and after moving the control settings to a separate page, it is no longer necessary to have simplified motor docs.
2020-01-28 17:51:23 +01:00
Laurens Valk
1ba961b29c
doc/builtins: simplify motor docs
...
Reduce unnecessary details for motor methods
2020-01-28 17:41:36 +01:00
Laurens Valk
2bb1fe2cb7
doc/motors: move Control class to dedicated place.
...
This way the DriveBase can refer to it too.
2020-01-28 17:09:21 +01:00
Laurens Valk
36a393c927
api/builtins/Control: introduce Control class
...
This is a generic class to interact with PID Controllers. A Motor has one control instance (for angle) and a drivebase will have two (one for heading, one for distance).
This will replace the motor specific settings
2020-01-28 16:25:53 +01:00
Laurens Valk
4faa5d3df8
doc/hubs.EV3Brick: toggle note specs
...
This condenses long lists that are not frequently used.
2020-01-27 13:25:42 +01:00
Laurens Valk
167cf3ad18
doc/builtins/Speaker: use '' for string settings
...
Also simplify by not listing all the options twice, and follow style for default argument.
2020-01-27 13:12:57 +01:00
Laurens Valk
aac25bb050
doc/media/ev3dev: fix ' in docstring
...
Also update todo note.
2020-01-27 13:07:51 +01:00
Laurens Valk
4bff13b5ca
doc: drop separate sound page
...
The sound is not independently useable, and it is already documented for the speaker.
2020-01-27 13:03:41 +01:00
Laurens Valk
08e63e69ca
api/builtins/DCMotor: drop settings
...
These settings are control properties, so they cannot be altered on DC Motors.
2020-01-27 12:56:47 +01:00
Laurens Valk
a029757b4a
doc/robotics: hide non-implemented methods
2020-01-27 12:51:48 +01:00
Laurens Valk
1c801f1520
api/robotics: add tank method
...
Also, group similar methods together and explain what they do.
2020-01-27 11:20:07 +01:00
Laurens Valk
dd39a2e00f
api/robotics: update DriveBase API
...
Make arc a non-blocking function similar to drive. This allows users to drive the robot along an arc until a sensor (e.g. color) is triggered, instead of relying on the rotation sensors only.
This also lets us simplify the language of some other method docstrings.
2020-01-23 17:58:24 +01:00
Laurens Valk
f5094cfaba
config: use inline math and common characters
...
Latex errors cannot be parsed by humans, so just use inline math which we had working elsewhere already.
Also use simplified character for ế, for latex compatibility.
2020-01-16 15:03:54 +01:00
Laurens Valk
686a3b8147
doc/media: update to say that these are ev3dev media
2020-01-16 14:31:14 +01:00
Laurens Valk
09a2e3eed9
doc/media/ev3dev: move files back to top
...
These are the most used. Also add separate heading for images/sounds so they can easily be found through menu.
Also lower currently mixed case rubric titles.
It would still be nice to make these lists shorter, perhaps using a dropdown or table.
2020-01-16 14:30:23 +01:00
Laurens Valk
022f15a437
config/spelling: ignore literals, data directives
2020-01-16 14:22:21 +01:00
Laurens Valk
00f5b9e13b
doc/screen: simplify print doc
...
Only say what it does, not what it doesn't do.
Also delete "on the image" because this is also used for the screen.
2020-01-16 13:48:56 +01:00
Laurens Valk
f7ff1e511e
api/builtins/ColorLight: remove brightness
...
Brightness control will not be implemented for the next release, so remove it.
2020-01-16 13:34:18 +01:00
Laurens Valk
90314b3f49
api/ev3.speaker: Fix missing language arg
...
This was added to the docstring but not the method.
2020-01-16 13:31:04 +01:00
Laurens Valk
b6f75eca9c
config: ignore literals by regexp and config files
...
No need to have all of them in the ignore list now.
2020-01-16 13:28:09 +01:00
Laurens Valk
81626bb20d
config: more spellchecking and ignoring
2020-01-16 12:02:50 +01:00
Laurens Valk
f597ed1f88
config: ignore math during spell check
2020-01-16 11:57:19 +01:00
Laurens Valk
834a2173b4
doc/builtins: fix typos
2020-01-16 11:40:34 +01:00
Laurens Valk
efb6d18ff8
doc/ev3.speaker: strings have quotes
2020-01-16 11:39:51 +01:00
Laurens Valk
a026e3a12c
config: ignore language identifiers
2020-01-16 11:39:08 +01:00
Laurens Valk
fe255a9611
config: sort ignored words
...
No longer have two lists of technical words and regular words.
also add a few more words
2020-01-16 11:31:37 +01:00
Laurens Valk
50a9d36314
api/ev3.speaker: separate language and voice settings
2020-01-16 11:25:13 +01:00
Laurens Valk
3e16ec2ba5
config: use Spell Right for spell checking
...
Also add initial list of words to ignore
2020-01-16 11:16:39 +01:00
Laurens Valk
8904413084
doc/speaker: Put language under show/hide toggle
...
This list is rather long, so hide it by default.
2020-01-16 10:34:56 +01:00
Laurens Valk
7a16c637aa
doc/speaker: fix typo
2020-01-16 10:27:31 +01:00
David Lechner
dc82ccce40
resources renamed to media.ev3dev
2020-01-14 17:32:40 -06:00
Laurens Valk
a6e6de28b5
api/nxtdevices: update sound audible argument
...
rename to audible_only for a more precise description.
2020-01-14 21:27:01 +01:00
Laurens Valk
4546f2b548
doc/signaltype: group units by type
...
There are now quite a few units, so organize them by physical category.
2020-01-14 21:12:00 +01:00
Laurens Valk
c1255e6b95
doc/signaltypes: add temperature conversions
2020-01-14 20:58:55 +01:00