Re: More everything into the octave namespace

[Carnë Draug]

On 16 August 2016 at 15:24, John W. Eaton <address@hidden> wrote:
>
> On August 16, 2016 9:19:13 AM EDT, "Carnë Draug" <address@hidden> wrote:
>>
>> On 11 August 2016 at 05:11, Carnë Draug <address@hidden> wrote:
>>>
>>> The doxygen docs were updated recently so we can have a list of the
>>> current existing classes [1].
>>> [...]
>>>
>>> [1] http://octave.org/doxygen/4.1/annotated.html
>
>>Rik mentioned feature freeze the day after my original email so this
>>change won't go through to 4.4 anyway.  However, there's classes that
>>are new for Octave 4.2, and others that have changed since 4.0.  These
>>are the ones that could be moved right away.
>
> OK, let's identify those classes and fix them now.
>

It's the diff between these two pages:

    http://octave.org/doxygen/4.0/annotated.html
    http://octave.org/doxygen/4.1/annotated.html

Here's what I did for future reference:

  $ wget -O 40classes http://octave.org/doxygen/4.0/annotated.html
  $ wget -O 41classes http://octave.org/doxygen/4.1/annotated.html
  $ grep -P '^<tr' 40classes | grep -Po
'(?<=target="_self">).+?(?=</a>)' | sort > 40-class-names
  $ grep -P '^<tr' 41classes | grep -Po
'(?<=target="_self">).+?(?=</a>)' | sort > 41-class-names
  $ diff --unified 40-class-names 41-class-names | grep '^+'
  +++ 41-class-names    2016-08-16 15:56:58.559609249 +0100
  +aepbalance
  +application
  +base_interrupt_manager
  +base_lexer
  +base_parser
  +base_text_renderer
  +base_tm
  +bp_type
  +ButtonGroup
  +CFile
  +child
  +child_list
  +child_list_rep
  +chol
  +complex_index_exception
  +cpu_time
  +cxsparse_defaults
  +cxsparse_defaults&lt; SparseComplexMatrix &gt;
  +cxsparse_defaults&lt; SparseMatrix &gt;
  +cxsparse_types
  +cxsparse_types&lt; SparseComplexMatrix &gt;
  +cxsparse_types&lt; SparseMatrix &gt;
  +delimited_stream
  +directory_path
  +dynamic_library
  +dynlib_rep
  +eealso
  +env
  +equiv
  +font
  +ft_text_renderer
  +gepbalance
  +gmtime
  +group
  +gui_application
  +hess
  +index_exception
  +interpreter
  +interrupt_handler
  +interrupt_manager
  +invalid_index
  +JVMArgs
  +lexer
  +light
  +localtime
  +lu
  +mach_info
  +marker
  +octave
  +octave_cmd_debug
  +octave_command_queue
  +octave_execution_exception
  +octave_getopt_options
  +ode
  +opengl_tesselator
  +opengl_texture
  +out_of_range
  +parser
  +password
  +patch_tesselator
  +posix_interrupt_manager
  +properties
  +properties
  +push_lexer
  +push_parser
  +qr
  +qrp
  +QTabWidget
  +resource_usage
  +schur
  +session_data
  +sigset_info
  +sparse_chol
  +sparse_chol_rep
  +sparse_lu
  +sparse_qr
  +sparse_qr_rep
  +string
  +strptime
  +svd
  +sys
  +tab_info
  +tab_widget
  +text_renderer
  +textscan
  +textscan_format_elt
  +textscan_format_list
  +texture_rep
  +time
  +trong
  +uibuttongroup
  +uname
  +vertex_data
  +vertex_data_rep

Grepping for "-" would show the classes that disappeared.

The problem with this approach is that:

  1 - it includes classes that are only used internally.
  2 - does not show the enclosing class for nested classes (for example,
    the new string class, is actually nested inside text_renderer which
    itself is a new class)

I think at this point they have be to be looked at manually.

Also, we need to decide in which namespace are putting each one of them.
I think you mentioned on IRC that we don't want to have too many namespace
and I agree.  So what namespaces will we have under octave? math, parser,
gui, graphics, interpreter?