Session API and documentation

src/main/java/com/frostwire/jlibtorrent/Session.java

@@ -390,19 +390,29 @@ public boolean isListening() {
     }
 
     /**
-     * Loads and saves all session settings, including dht_settings,
-     * encryption settings and proxy settings. ``save_state`` writes all keys
-     * to the ``entry`` that's passed in, which needs to either not be
-     * initialized, or initialized as a dictionary.
+     * Loads and saves all session settings, including dht settings,
+     * encryption settings and proxy settings. {@link #saveState()}
+     * internally writes all keys to an {@link entry} that's passed in,
+     * which needs to either not be initialized, or initialized as a dictionary.
      * <p/>
-     * ``load_state`` expects a lazy_entry which can be built from a bencoded
-     * buffer with lazy_bdecode().
-     * <p/>
-     * The ``flags`` arguments passed in to ``save_state`` can be used to
+     * The {@code flags} arguments passed in to this method can be used to
      * filter which parts of the session state to save. By default, all state
-     * is saved (except for the individual torrents). see save_state_flags_t
+     * is saved (except for the individual torrents).
+     * See {@link com.frostwire.jlibtorrent.swig.session_handle.save_state_flags_t}
+     *
+     * @return
+     */
+    public byte[] saveState(long flags) {
+        entry e = new entry();
+        s.save_state(e);
+        return Vectors.byte_vector2bytes(e.bencode());
+    }
+
+    /**
+     * Same as calling {@link #saveState(long)} with all save state flags.
      *
      * @return
+     * @see #saveState(long)
      */
     public byte[] saveState() {
         entry e = new entry();