[jira] Commented: (DERBY-3518) Getting started guide: Incomplete instructions for compiling WwdEmbedded.java

["Kim Haase (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DERBY-3518?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12777982#action_12777982 ] 

Kim Haase commented on DERBY-3518:
----------------------------------

Actually, WwdClientExample.java is provided just as a sanity check for Activity 4, though I don't think it is mentioned there. Activity 3 should probably mention only the embedded example and the utility class, unless you want to modify Activity 4 too.

Activity 4 tells people to copy the embedded program to WwdClient.java and make the two changes that turn it into a client example. 

If you wanted to to go to the bother of modifying Activity 4, you *could* change that topic to tell people to check their edited program against WwdClientExample.java. A more elaborate change would to tell them, instead of copying the file and making the changes, to open WwdClientExample.java in a text editor and notice the differences from the embedded program and then run it.

Your call ... Thanks for dealing with this issue!

> Getting started guide: Incomplete instructions for compiling WwdEmbedded.java
> -----------------------------------------------------------------------------
>
>                 Key: DERBY-3518
>                 URL: https://issues.apache.org/jira/browse/DERBY-3518
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.3.2.1
>            Reporter: John H. Embretsen
>            Assignee: Bryan Pendleton
>            Priority: Minor
>         Attachments: docs.diff, twwdactivity3_Setup.html
>
>
> In the Getting Started with Derby manual's Self-study tutorial for users new to Derby, there is an Activity 3 which describes how to run a JDBC program using the embedded driver: http://db.apache.org/derby/docs/dev/getstart/twwdactivity3_Setup.html .
> In step 2, the guide says:
> <quote>
> Compile the WwdEmbedded.java program.
> javac WwdEmbedded.java
> </quote>
> Since WwdEmbedded.java (available from <bin-installation>/demo/programs/workingwithderby/) references the WwdUtils class, WwdUtils.java needs to be copied and compiled as well. Otherwise, compiling will fail with:
> WwdEmbedded.java:80: cannot resolve symbol
> symbol  : variable WwdUtils
> location: class WwdEmbedded
>              if (! WwdUtils.wwdChk4Table(conn))
>                    ^
> WwdEmbedded.java:92: cannot resolve symbol
> symbol  : variable WwdUtils
> location: class WwdEmbedded
>                 answer = WwdUtils.getWishItem();
>                          ^
> 2 errors
> The manual should be updated to reflect this requirement.
> This issue was first reported on the derby-user mailing list 2008-03-06 by Tosca Lahiri, see http://www.nabble.com/javac-WwdEmbedded.java-td15924527.html

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.