Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update to debugger documentation for 4.x #118

Merged
merged 4 commits into from May 5, 2015

Conversation

Kwestor
Copy link
Member

@Kwestor Kwestor commented Apr 27, 2015

Out-of-date information removed.

Further improvements description tidied up and updated (to my best
knowledge).

Placeholders for drop to frame, expression evaluator and HCR added.

@sschaef @dragos if you could look especially on Further improvements and unsupported features section, maybe some more things should be removed from there.

TODOs:

  • docs for drop to frame
  • docs for HCR
  • docs for expresison evaluator

Disclaimer required by the lawyers:

THE FOLLOWING DISCLAIMER APPLIES TO ALL SOFTWARE CODE AND OTHER MATERIALS CONTRIBUTED IN CONNECTION WITH THIS SOFTWARE:
THIS SOFTWARE IS LICENSED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY OF NON-INFRINGEMENT, ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THIS SOFTWARE MAY BE REDISTRIBUTED TO OTHERS ONLY BY EFFECTIVELY USING THIS OR ANOTHER EQUIVALENT DISCLAIMER IN ADDITION TO ANY OTHER REQUIRED LICENSE TERMS.
ONLY THE SOFTWARE CODE AND OTHER MATERIALS CONTRIBUTED IN CONNECTION WITH THIS SOFTWARE, IF ANY, THAT ARE ATTACHED TO (OR OTHERWISE ACCOMPANY) THIS SUBMISSION (AND ORDINARY COURSE CONTRIBUTIONS OF FUTURES PATCHES THERETO) ARE TO BE CONSIDERED A CONTRIBUTION. NO OTHER SOFTWARE CODE OR MATERIALS ARE A CONTRIBUTION.

@Kwestor Kwestor force-pushed the update-debugger-docs branch 3 times, most recently from 3d085ed to f6397cf Compare April 27, 2015 16:02
@kiritsuku
Copy link
Member

You can add further commits to this PR, no need to split them up in multiple PRs.


*may not be exhaustive or up-to-date, not really ordered*
Further improvements and unsupported features
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we should have this section at all. If there is a problem, the ticket tracker should keep it.

@Kwestor
Copy link
Member Author

Kwestor commented Apr 28, 2015

Ok, I'll add all docs change into this PR.

@Kwestor Kwestor force-pushed the update-debugger-docs branch 2 times, most recently from e2c5fdc to 9667f3d Compare April 29, 2015 11:28
Hot code replace |new| (since 4.1)
----------------------------------

Hot code replace adds the possibility to modify and re-compile code in a debug mode and to have these changes visible
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are these new lines in the middle of sentences needed (maybe some formatting requirements)? Or do we have them e.g. because they were in the description of a commit/PR?

I'm just asking. :)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just breaking lines at ~120 character mark.

@Kwestor Kwestor force-pushed the update-debugger-docs branch 4 times, most recently from 02541d4 to 8fe4e14 Compare April 30, 2015 14:17
@Kwestor
Copy link
Member Author

Kwestor commented Apr 30, 2015

User docs for expression evaluator added. @sschaef @dragos @wpopielarski, could you please take a look?

from breakpoint and (possibly) modification of state of your application.

.. image:: images/expression-evaluator/expression.png
:alt: Sample expression evaluation
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some of these images look bad when they are rendered, they are too wide. Add :width: 100% as a tag to inline them into the layout.

@Kwestor
Copy link
Member Author

Kwestor commented May 4, 2015

Updated.

Kwestor and others added 4 commits May 5, 2015 10:13
`expression` plug-in added in multiple places in docs.

Out-of-date information removed.

Further improvements description tidied up and updated (to my best
knowledge).

Placeholders for drop to frame, expression evaluator and HCR added.
Now it should be clearer how they work and what to expect.
@Kwestor
Copy link
Member Author

Kwestor commented May 5, 2015

Improvements by @mpociecha added.

@kiritsuku
Copy link
Member

LGTM

kiritsuku added a commit that referenced this pull request May 5, 2015
Update to debugger documentation for 4.x
@kiritsuku kiritsuku merged commit d1007da into scala-ide:master May 5, 2015
@Kwestor Kwestor deleted the update-debugger-docs branch May 12, 2015 11:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants