Organize/add docstrings in API docs (#945)

* Remove duplicate documentation src file

* Explicitly list API docstrings to include and group under headings

* Add @docs blocks for important functions/types currently missing docstrings.

Author: jlumpe

docs/src/internals.md

@@ -1,3 +1,106 @@
 # Internals
 
-TODO
+
+## Initialization
+
+```@docs
+IJulia.init
+```
+
+
+## Cell execution hooks
+
+```@docs
+IJulia.pop_posterror_hook
+IJulia.pop_postexecute_hook
+IJulia.pop_preexecute_hook
+IJulia.push_posterror_hook
+IJulia.push_postexecute_hook
+IJulia.push_preexecute_hook
+```
+
+
+## Messaging
+
+```@docs
+IJulia.Msg
+IJulia.msg_header
+IJulia.send_ipython
+IJulia.recv_ipython
+IJulia.set_cur_msg
+IJulia.send_status
+```
+
+
+## Request handlers
+
+```@docs
+IJulia.handlers
+IJulia.connect_request
+IJulia.execute_request
+IJulia.shutdown_request
+IJulia.interrupt_request
+IJulia.inspect_request
+IJulia.history_request
+IJulia.complete_request
+IJulia.kernel_info_request
+IJulia.is_complete_request
+```
+
+
+## Event loop
+
+```@docs
+IJulia.eventloop
+IJulia.waitloop
+```
+
+
+## IO
+
+```@docs
+IJulia.IJuliaStdio
+IJulia.capture_stdout
+IJulia.capture_stderr
+IJulia.watch_stream
+```
+
+
+## Multimedia display
+
+```@docs
+IJulia.InlineDisplay
+IJulia.InlineIOContext
+IJulia.ipy_mime
+IJulia.ijulia_mime_types
+IJulia.ijulia_jsonmime_types
+IJulia.limitstringmime
+IJulia.israwtext
+IJulia.display_dict
+IJulia.display_mimejson
+IJulia.display_mimestring
+IJulia.register_mime
+IJulia.register_jsonmime
+```
+
+
+## Jupyter
+
+```@docs
+IJulia.find_jupyter_subcommand
+IJulia.launch
+```
+
+
+## Debugging
+
+```@docs
+IJulia.set_verbose
+```
+
+
+## Utility
+
+```@docs
+IJulia.num_utf8_trailing
+```

docs/src/library/internals.md

@@ -1,6 +1,48 @@
 # Public API
 
 
-```@autodocs
-Modules = [ IJulia ]
+## General
+
+```@docs
+IJulia.IJulia
+IJulia.inited
+IJulia.installkernel
+```
+
+
+## Launching the server
+
+```@docs
+IJulia.jupyterlab
+IJulia.notebook
+IJulia.qtconsole
+```
+
+
+## History
+
+```@docs
+IJulia.In
+IJulia.Out
+IJulia.ans
+IJulia.n
+IJulia.clear_history
+IJulia.history
+```
+
+
+## Cells
+
+```@docs
+IJulia.clear_output
+IJulia.load
+IJulia.load_string
+```
+
+
+## I/O
+
+```@docs
+IJulia.readprompt
+IJulia.set_max_stdio
 ```