Difference between revisions of "Hacker Guide/VLC source tree"

From VideoLAN Wiki
Jump to navigation Jump to search
 
m (+{{Back to|Hacker Guide}})
 
(31 intermediate revisions by 9 users not shown)
Line 1: Line 1:
This page lists the directories in the source tree of VLC, aimed at giving new beginners an overview of the code.
+
{{Back to|Hacker Guide}}
 +
This page lists the directories in the [https://git.videolan.org/?p=vlc.git;a=tree source tree of VLC] to give an overview of the code.  Because VLC has evolved with not so much accumulation in mind, when a new coder looks at the code, s/he is terrified by the abundance of directories. This page was prepared to remedy that situation.
  
The directories are listed in alphabetical order, with an overview of their contents on the right:
+
The directories are listed in alphabetical order, with an overview of their contents on the right.
 +
{| class="wikitable"
  
Directory Name        Directory Explanation
+
|-
 +
! Directory Name         
 +
! Directory Explanation
 +
|-
 +
|bindings               
 +
|Java, CIL and Python bindings
 +
|-
 +
| {{VLCSourceFolder|contrib}}
 +
| for required libraries (contains Makefiles to automatically download and compile (or cross-compile) and patch those). Please first attempt to get the development headers precompiled for your distribution.
 +
|-
 +
|{{VLCSourceFolder|doc}}              
 +
|Documentation (not up-to-date)
 +
|-
 +
|{{VLCSourceFolder|extras}}
 +
| ''[[#Contents_of_extras|See below]]''
 +
|-
 +
|{{VLCSourceFolder|include}}              
 +
|Header files for VLC
 +
|-
 +
|{{VLCSourceFolder|lib}}             
 +
|Contains all [[LibVLC]] control code
 +
|-
 +
|{{VLCSourceFolder|m4}}              
 +
|Macro files needed for automake and autoconf
 +
|-
 +
|{{VLCSourceFolder|modules}}
 +
|The most important directory besides src/. ''See [[{{#rel2abs:../Modules source tree}}]].''
 +
|-
 +
|{{VLCSourceFolder|po}}
 +
|i18n (language translation) files
 +
|-
 +
|projects
 +
| Projects based on libvlc, Mozilla plugin, ActiveX plugin and [[Mac OS X Framework]]
 +
|-
 +
|{{VLCSourceFolder|share}}
 +
|icons, scripts to make VLC the default player etc.
 +
|-
 +
|{{VLCSourceFolder|src}}
 +
|The most important directory besides modules/. ''See [[{{#rel2abs:/src}}|src source tree]].''
 +
|-
 +
|{{VLCSourceFolder|test}}
 +
|scripts to see if everything is OK
  
activex               activex bindings
+
|}
  
bindings                Java and Python bindings
+
== Contents of extras ==
 +
{| class="wikitable"
 +
| {{VLCSourceFolder|extras/analyser}}
 +
| contains some code style editor (vim, emacs) macro and some valgrind suppressions
 +
|-
 +
| {{VLCSourceFolder|extras/buildsystem}}
 +
| contains alternative buildsystems
 +
|-
 +
| extras/deprecated
 +
| contains deprecated files
 +
|-
 +
| {{VLCSourceFolder|extras/misc}}
 +
| contains files that don't fit into any other category
 +
|-
 +
| {{VLCSourceFolder|extras/package}}
 +
| contains distribution specific files such as ipkg, different rpm spec files, win32 and Mac OS X installation files.
 +
|-
 +
|}
  
doc               Documentation (not up-to-date)
+
{{Hacker Guide}}
 
+
[[Category:Building]]
evc               I don't know
 
 
 
extras -
 
        -contrib (subdirectory of extras) - for required libraries (contains Makefiles to automatically download and compile (or cross-compile) and patch those. Please first attempt to get the development headers precompiled for your distribution.
 
        extras also contains the emacs.init file (useful for coding in Videolan style)
 
 
 
 
include               Header files for vlc
 
 
 
ipkg               I guess this is not so important, last modified 2 years ago!
 
 
 
libs               Loader and secure rtp libraries
 
 
 
lxdialog               I guess this is not important, last modified 1 year ago!
 
 
 
m4               Macro files needed for ???
 
 
modules -most important directory --todo
 
 
 
mozilla               Mozilla plugin
 
 
 
msvc Deprecated, Microsoft Visual C files I guess
 
 
 
po i18n files
 
 
 
python -not important
 
 
 
share -icons,scripts to make default player etc.
 
 
 
src -to-do
 
 
 
test -scripts to see if everything is OK
 

Latest revision as of 06:40, 17 April 2019

← Back to Hacker Guide
This page lists the directories in the source tree of VLC to give an overview of the code. Because VLC has evolved with not so much accumulation in mind, when a new coder looks at the code, s/he is terrified by the abundance of directories. This page was prepared to remedy that situation.

The directories are listed in alphabetical order, with an overview of their contents on the right.

Directory Name Directory Explanation
bindings Java, CIL and Python bindings
contrib for required libraries (contains Makefiles to automatically download and compile (or cross-compile) and patch those). Please first attempt to get the development headers precompiled for your distribution.
doc Documentation (not up-to-date)
extras See below
include Header files for VLC
lib Contains all LibVLC control code
m4 Macro files needed for automake and autoconf
modules The most important directory besides src/. See Hacker Guide/Modules source tree.
po i18n (language translation) files
projects Projects based on libvlc, Mozilla plugin, ActiveX plugin and Mac OS X Framework
share icons, scripts to make VLC the default player etc.
src The most important directory besides modules/. See src source tree.
test scripts to see if everything is OK

Contents of extras

extras/analyser contains some code style editor (vim, emacs) macro and some valgrind suppressions
extras/buildsystem contains alternative buildsystems
extras/deprecated contains deprecated files
extras/misc contains files that don't fit into any other category
extras/package contains distribution specific files such as ipkg, different rpm spec files, win32 and Mac OS X installation files.
This page is part of official VLC media player Documentation (User GuideStreaming HowToHacker GuideModules)
Please read the Documentation Editing Guidelines before you edit the documentation
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.