]> git.sesse.net Git - vlc/blobdiff - src/libvlc.h
Fix a grammar mistake
[vlc] / src / libvlc.h
index d8db7ef63fb165c27196dd07dfe95a5172f9d9c1..614b68a354e77a9ea1ed6e93bbcbc985eb60aed4 100644 (file)
@@ -334,6 +334,7 @@ static char *ppsz_align_descriptions[] =
     "pixels (1:1). If you have a 16:9 screen, you might need to change this " \
     "to 4:3 in order to keep proportions.")
 
+/// \bug [String] Remove "this option"
 #define SKIP_FRAMES_TEXT N_("Skip frames")
 #define SKIP_FRAMES_LONGTEXT N_( \
     "This option enables framedropping on MPEG2 stream. Framedropping " \
@@ -447,16 +448,16 @@ static char *ppsz_clock_descriptions[] =
     "Stream ID of the subtitle track to use.")
 
 #define INPUT_REPEAT_TEXT N_("Input repetitions")
-#define INPUT_REPEAT_LONGTEXT N_("Number of time the same input will be " \
-                                 "repeated")
+#define INPUT_REPEAT_LONGTEXT N_( \
+    "Number of time the same input will be repeated")
 
 #define START_TIME_TEXT N_("Start time")
-#define START_TIME_LONGTEXT N_("The stream will start at this position " \
-             "(in seconds)." )
+#define START_TIME_LONGTEXT N_( \
+    "The stream will start at this position (in seconds)." )
 
 #define STOP_TIME_TEXT N_("Stop time")
-#define STOP_TIME_LONGTEXT N_("The stream will stop at this position " \
-             "(in seconds)." )
+#define STOP_TIME_LONGTEXT N_( \
+    "The stream will stop at this position (in seconds)." )
 
 #define INPUT_LIST_TEXT N_("Input list")
 #define INPUT_LIST_LONGTEXT N_( \
@@ -470,8 +471,8 @@ static char *ppsz_clock_descriptions[] =
     "are supported. Use a '#' separated list of inputs.")
 
 #define BOOKMARKS_TEXT N_("Bookmarks list for a stream")
-#define BOOKMARKS_LONGTEXT N_( "You can manually give a list of "  \
-    "bookmarks for a stream in " \
+#define BOOKMARKS_LONGTEXT N_( \
+    "You can manually give a list of bookmarks for a stream in " \
     "the form \"{name=bookmark-name,time=optional-time-offset," \
     "bytes=optional-byte-offset},{...}\"")
 
@@ -497,19 +498,24 @@ static char *ppsz_clock_descriptions[] =
     "VLC can display messages on the video. This is called OSD (On Screen " \
     "Display).")
 
+#define TEXTRENDERER_TEXT N_("Text rendering module")
+#define TEXTRENDERER_LONGTEXT N_( \
+    "VLC normally uses Freetype for rendering, but this allows you to use svg for instance.")
+
+/// \bug typo arbitraty
 #define SUB_FILTER_TEXT N_("Subpictures filter module")
 #define SUB_FILTER_LONGTEXT N_( \
-    "This addds so-called \"subpicture filters\". These filters overlay " \
+    "This adds so-called \"subpicture filters\". These filters overlay " \
     "some images or text over the video (like a logo, arbitraty text...)." )
 
 #define SUB_AUTO_TEXT N_("Autodetect subtitle files")
-#define SUB_AUTO_LONGTEXT \
-    N_("Automatically detect a subtitle file, if no subtitle filename is " \
+#define SUB_AUTO_LONGTEXT N_( \
+    "Automatically detect a subtitle file, if no subtitle filename is " \
     "specified (based on the filename of the movie).")
 
 #define SUB_FUZZY_TEXT N_("Subtitle autodetection fuzziness")
-#define SUB_FUZZY_LONGTEXT \
-    N_("This determines how fuzzy subtitle and movie filename matching " \
+#define SUB_FUZZY_LONGTEXT N_( \
+    "This determines how fuzzy subtitle and movie filename matching " \
     "will be. Options are:\n" \
     "0 = no subtitles autodetected\n" \
     "1 = any subtitle file\n" \
@@ -518,13 +524,13 @@ static char *ppsz_clock_descriptions[] =
     "4 = subtitle file matching the movie name exactly")
 
 #define SUB_PATH_TEXT N_("Subtitle autodetection paths")
-#define SUB_PATH_LONGTEXT \
-    N_("Look for a subtitle file in those paths too, if your subtitle " \
+#define SUB_PATH_LONGTEXT N_( \
+    "Look for a subtitle file in those paths too, if your subtitle " \
     "file was not found in the current directory.")
 
 #define SUB_FILE_TEXT N_("Use subtitle file")
-#define SUB_FILE_LONGTEXT \
-    N_("Load this subtitle file. To be used when autodetect cannot detect " \
+#define SUB_FILE_LONGTEXT N_( \
+    "Load this subtitle file. To be used when autodetect cannot detect " \
     "your subtitle file.")
 
 #define DVD_DEV_TEXT N_("DVD device")
@@ -563,7 +569,7 @@ static char *ppsz_clock_descriptions[] =
 
 #define IPV4_TEXT N_("Force IPv4")
 #define IPV4_LONGTEXT N_( \
-    " IPv4 will be used by default for all connections.")
+    "IPv4 will be used by default for all connections.")
 
 #define TIMEOUT_TEXT N_("TCP connection timeout")
 #define TIMEOUT_LONGTEXT N_( \
@@ -575,12 +581,12 @@ static char *ppsz_clock_descriptions[] =
     "address:port. It will be used for all TCP connections" )
 
 #define SOCKS_USER_TEXT N_("SOCKS user name")
-#define SOCKS_USER_LONGTEXT N_("User name to be used for connection to " \
-    "the SOCKS proxy." )
+#define SOCKS_USER_LONGTEXT N_( \
+    "User name to be used for connection to the SOCKS proxy." )
 
 #define SOCKS_PASS_TEXT N_("SOCKS password")
-#define SOCKS_PASS_LONGTEXT N_("Password to be used for connection to "\
-    "the SOCKS proxy." )
+#define SOCKS_PASS_LONGTEXT N_( \
+    "Password to be used for connection to the SOCKS proxy." )
 
 #define META_TITLE_TEXT N_("Title metadata")
 #define META_TITLE_LONGTEXT N_( \
@@ -649,7 +655,7 @@ static char *ppsz_clock_descriptions[] =
 
 #define SOUT_ALL_TEXT N_("Enable streaming of all ES")
 #define SOUT_ALL_LONGTEXT N_( \
-    "Stream all ES (video, audio and subtitles)")
+    "Stream all elementary streams (video, audio and subtitles)")
 
 #define SOUT_DISPLAY_TEXT N_("Display while streaming")
 #define SOUT_DISPLAY_LONGTEXT N_( \
@@ -690,12 +696,14 @@ static char *ppsz_clock_descriptions[] =
     "This is a legacy entry to let you configure access output modules")
 
 #define ANN_SAPCTRL_TEXT N_("Control SAP flow")
-#define ANN_SAPCTRL_LONGTEXT N_("If this option is enabled, the flow on " \
+#define ANN_SAPCTRL_LONGTEXT N_( \
+    "If this option is enabled, the flow on " \
     "the SAP multicast address will be controlled. This is needed if you " \
     "want to make announcements on the MBone." )
 
 #define ANN_SAPINTV_TEXT N_("SAP announcement interval")
-#define ANN_SAPINTV_LONGTEXT N_("When the SAP flow control is disabled, " \
+#define ANN_SAPINTV_LONGTEXT N_( \
+    "When the SAP flow control is disabled, " \
     "this lets you set the fixed interval between SAP announcements." )
 
 
@@ -795,7 +803,7 @@ static char *ppsz_clock_descriptions[] =
 
 #define VLM_CONF_TEXT N_("VLM configuration file")
 #define VLM_CONF_LONGTEXT N_( \
-    "Read a VLM configuration file as son as it is started." )
+    "Read a VLM configuration file as soon as VLM is started." )
 
 #define PLUGINS_CACHE_TEXT N_("Use a plugins cache")
 #define PLUGINS_CACHE_LONGTEXT N_( \
@@ -810,19 +818,30 @@ static char *ppsz_clock_descriptions[] =
      "Runs VLC as a background daemon process.")
 
 #define FILE_LOG_TEXT N_( "Log to file" )
-#define FILE_LOG_LONGTEXT N_( "Log all VLC messages to a text file." )
+#define FILE_LOG_LONGTEXT N_( \
+    "Log all VLC messages to a text file." )
 
 #define SYSLOG_TEXT N_( "Log to syslog" )
-#define SYSLOG_LONGTEXT N_( "Log all VLC messages to syslog (UNIX systems)." )
+#define SYSLOG_LONGTEXT N_( \
+    "Log all VLC messages to syslog (UNIX systems)." )
 
 #define ONEINSTANCE_TEXT N_("Allow only one running instance")
 #define ONEINSTANCE_LONGTEXT N_( \
     "Allowing only one running instance of VLC can sometimes be useful, " \
-    "for instance if you associated VLC with some media types and you " \
+    "for example if you associated VLC with some media types and you " \
     "don't want a new instance of VLC to be opened each time you " \
     "double-click on a file in the explorer. This option will allow you " \
     "to play the file with the already running instance or enqueue it.")
 
+#define STARTEDFROMFILE_TEXT N_("VLC is started from file association")
+#define STARTEDFROMFILE_LONGTEXT N_( \
+    "Tell VLC that it is being launched due to a file association in the OS" )
+
+#define ONEINSTANCEWHENSTARTEDFROMFILE_TEXT N_( \
+    "Allow only on running instance when started from file")
+#define ONEINSTANCEWHENSTARTEDFROMFILE_LONGTEXT N_( \
+    "Allow only on running instance when started from file")
+
 #define HPRIORITY_TEXT N_("Increase the priority of the process")
 #define HPRIORITY_LONGTEXT N_( \
     "Increasing the priority of the process will very likely improve your " \
@@ -1213,6 +1232,8 @@ vlc_module_begin();
 
     add_bool( "spu", 1, NULL, SPU_TEXT, SPU_LONGTEXT, VLC_TRUE );
     add_bool( "osd", 1, NULL, OSD_TEXT, OSD_LONGTEXT, VLC_FALSE );
+    add_module( "text-renderer", "text renderer", NULL, NULL, TEXTRENDERER_TEXT,
+                TEXTRENDERER_LONGTEXT, VLC_TRUE );
 
     set_section( N_("Subtitles") , NULL );
     add_file( "sub-file", NULL, NULL, SUB_FILE_TEXT,
@@ -1276,7 +1297,7 @@ vlc_module_begin();
     add_string( "bookmarks", NULL, NULL,
                  BOOKMARKS_TEXT, BOOKMARKS_LONGTEXT, VLC_TRUE );
 
-    set_section( N_( "Default devices") , NULL )
+    set_section( N_( "Default devices") , NULL );
 
     add_file( "dvd", NULL, NULL, DVD_DEV_TEXT, DVD_DEV_LONGTEXT,
               VLC_FALSE );
@@ -1297,7 +1318,7 @@ vlc_module_begin();
     add_integer( "ipv4-timeout", 5 * 1000, NULL, TIMEOUT_TEXT,
                  TIMEOUT_LONGTEXT, VLC_TRUE );
 
-    set_section( N_( "Socks proxy") , NULL )
+    set_section( N_( "Socks proxy") , NULL );
     add_string( "socks", NULL, NULL,
                  SOCKS_SERVER_TEXT, SOCKS_SERVER_LONGTEXT, VLC_TRUE );
     add_string( "socks-user", NULL, NULL,
@@ -1306,7 +1327,7 @@ vlc_module_begin();
                  SOCKS_PASS_TEXT, SOCKS_PASS_LONGTEXT, VLC_TRUE );
 
 
-    set_section( N_("Metadata" ) , NULL )
+    set_section( N_("Metadata" ) , NULL );
     add_string( "meta-title", NULL, NULL, META_TITLE_TEXT,
                 META_TITLE_LONGTEXT, VLC_TRUE );
     add_string( "meta-author", NULL, NULL, META_AUTHOR_TEXT,
@@ -1454,6 +1475,11 @@ vlc_module_begin();
 #if defined(WIN32)
     add_bool( "one-instance", 0, NULL, ONEINSTANCE_TEXT,
               ONEINSTANCE_LONGTEXT, VLC_TRUE );
+    add_bool( "started-from-file", 0, NULL, STARTEDFROMFILE_TEXT,
+              STARTEDFROMFILE_LONGTEXT, VLC_TRUE );
+    add_bool( "one-instance-when-started-from-file", 1, NULL,
+              ONEINSTANCEWHENSTARTEDFROMFILE_TEXT,
+              ONEINSTANCEWHENSTARTEDFROMFILE_LONGTEXT, VLC_TRUE );
     add_bool( "playlist-enqueue", 0, NULL, PLAYLISTENQUEUE_TEXT,
               PLAYLISTENQUEUE_LONGTEXT, VLC_TRUE );
     add_bool( "high-priority", 0, NULL, HPRIORITY_TEXT,
@@ -1506,9 +1532,12 @@ vlc_module_begin();
                VLC_TRUE );
 #endif
 
+#if defined (WIN32) || defined (__APPLE__)
     add_string( "language", "auto", NULL, LANGUAGE_TEXT, LANGUAGE_LONGTEXT,
                 VLC_FALSE );
         change_string_list( ppsz_language, ppsz_language_text, 0 );
+#endif
+
     add_bool( "color", 0, NULL, COLOR_TEXT, COLOR_LONGTEXT, VLC_TRUE );
     add_bool( "advanced", 0, NULL, ADVANCED_TEXT, ADVANCED_LONGTEXT,
                     VLC_FALSE );
@@ -1889,7 +1918,7 @@ static module_config_t p_help_config[] =
     { CONFIG_ITEM_BOOL, NULL, "help", 'h',
       N_("print help for VLC (can be combined with --advanced)") },
     { CONFIG_ITEM_BOOL, NULL, "longhelp", 'H',
-      N_("print help for VLC and all it's modules (can be combined with --advanced)") },
+      N_("print help for VLC and all its modules (can be combined with --advanced)") },
     { CONFIG_ITEM_BOOL, NULL, "advanced", '\0',
       N_("print help for the advanced options") },
     { CONFIG_ITEM_BOOL, NULL, "help-verbose", '\0',