Everything you always wanted to know about reading lists...
============================================================

This is kind of long because is detailed. Attend the next class (10/02)
from the beginning (be on time!) and this will be a breeze.

First, go to http://vis.cs.brown.edu/resources/lists.html

There's a list of reading lists (...) that various people in the group
have created. They are basically collections of documents that relate
to a subject. The subject could be a project (although that belongs in
the project's webpage also in visweb), a small sub-project someone is
working on, a personal bibliography of interesting things, etc. It
could be anything you want, really.

The cool thing about this is that other people can access those lists
and you can share information easily with people this way.


For the class
=============


You need to make one reading list about your project proposal.

I created one list per person already, now you'll need to fill them
out. Since you are not group 'graphics' I needed to do that for you.

The lists are empty now and have your name in the title.


To get started...
=================

http://vis.cs.brown.edu/resources/doc/gfxtools-docs/index.html

The importat bit is in tutorial 1, but you should read the whole thing
to understand a little bit what you are doing. You'll need this to
make your reading list show up on the web.

Once you get your shell to recognize $G (you should be able to
'cd $G'), you may continue with this tutorial. If you cannot get it to
work email me (jr@cs) and I'll help you.


To add a document
=================

You need to be on a linux box in CS. Physically! No remote login.

Here are the steps:

1.- Check that the document in question is not already in visweb

    Go to http://vis.cs.brown.edu/search and look for title, author's
    last name, venue/journal, etc.

    a) If you find it:

       Write down the entry key. Something that looks like
       Acevedo-2002-ACR (that's lastname-year-acronym). That's the key
       that identifies an entry in visweb. IT IS CASE SENSITIVE!!

       Go to step 2!

    b) If you DON'T find it:

       Create the entry key your document will have in visweb. That's
       the key that identifies an entry in visweb. IT IS CASE
       SENSITIVE!!
       
       It has three parts: lastname-year-acronym

       + The 'lastname' is the first author's lastname, first letter
       capitalized.  
       + The 'year' is the year of publication.  
       + The 'acronym' is formed by the first letters of the first three
       words you capitalize in the title of the document. ALL CAPITALS!

       Example:

       "The Role of Visual Perception in Data Visualization" by Mehdi
       Dastani Published in Journal of Visual Languages and Computing
       in December 2002

       The key would be: Dastani-2002-RVP

       You are ready to create the document in visweb. Go to step 2.

2.- Adding a new document to visweb

    + Click on the 'Update' link at the top right corner of any visweb
    page.
    + Click on the 'Document' link

    + Don't worry about the 'Type of Document in VRL' pull down menu. 

    + Write your document's entry key
    + Click Continue

    A page beginning with 'Creating a new entry..." should show up.
    (If the document already exists, it'll tell you here)

    + Skip to the Reading Lists  section. Find your list and mark it.

       (If the document already exists, go to the bottom of the page
        and click 'Continue'.
        The next page should be already filled out. Click 'Continue'
        at the bottom. Follow the instructions in the next page.
        Go to STEP 3!)

    + Skip to the bottom of the page where 3 pull down menus are.
    + Select the type of document your entry is
    + Select the status
    + IMPORTANT!!Select 'VRL internal access' in the last menu. This will make
    your document's pdf only accesible by password (copyright
    issues...)
    + Click 'Continue'

    A page to add information about the document should show up. Fill
    out AT LEAST the fields with a '*' by them.
    
    + Type the authors separated by 'and' with no commas anywhere. For
    example, if the paper lists:

    Acevedo, D., Vote, E. and Laidlaw, D.

    First of all, that's a mess but, in any case, you should enter that
    list as:

    D. Acevedo and E. Vote and D. Laidlaw

    + If you have a document (doc, pdf, txt) select the appropriate 
      'Location' and write the FULL PATH to it.

    + Click 'Continue'

    You are almost done. Following the instructions on the page that
    shows up:

    + Go to a shell and type 'viswebupdate' (you should have this
    command already because you set up the $G variable before)

3.- YOU ARE DONE!!! Well, that was easy, ha?