Modify the interface of Suurballe (#266, #181)

- Move the parameters s and t from the constructor to the run()
function. It makes the interface capable for multiple run(s,t,k)
calls (possible improvement in the future) and it is more similar
to Dijkstra.
- Simliarly init() and findFlow(k) were replaced by init(s) and
findFlow(t,k). The separation of parameters s and t is for the
future plans of supporting multiple targets with one source node.
For more information see #181.
- LEMON_ASSERT for the Length type (check if it is integer).
- Doc improvements.
- Rearrange query functions.
- Extend test file.

 INCLUDE_DIRECTORIES(

   ${PROJECT_SOURCE_DIR}

   ${PROJECT_BINARY_DIR}

 )

 LINK_DIRECTORIES(${PROJECT_BINARY_DIR}/lemon)

 SET(DEMOS

   arg_parser_demo

   graph_to_eps_demo

   lgf_demo)

 FOREACH(DEMO_NAME ${DEMOS})

   ADD_EXECUTABLE(${DEMO_NAME} ${DEMO_NAME}.cc)

   TARGET_LINK_LIBRARIES(${DEMO_NAME} lemon)

 ENDFOREACH(DEMO_NAME)