summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/synctexdir/synctex_main.c
diff options
context:
space:
mode:
authorJonathan Kew <jfkthame@googlemail.com>2008-06-05 23:02:47 +0000
committerJonathan Kew <jfkthame@googlemail.com>2008-06-05 23:02:47 +0000
commit83974ab93e29bec748c12c0da4ce743f66c79e3e (patch)
tree9fc60ed84023a1e09d0f907c107b2ec2b8cf35de /Build/source/texk/web2c/synctexdir/synctex_main.c
parent7bb69e35cc4bf73d2fd494f92791fa06c02ad2a2 (diff)
moved synctex to synctexdir to avoid name clash when building in-place
git-svn-id: svn://tug.org/texlive/trunk@8586 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/synctexdir/synctex_main.c')
-rw-r--r--Build/source/texk/web2c/synctexdir/synctex_main.c735
1 files changed, 735 insertions, 0 deletions
diff --git a/Build/source/texk/web2c/synctexdir/synctex_main.c b/Build/source/texk/web2c/synctexdir/synctex_main.c
new file mode 100644
index 00000000000..76d1fe8f9d7
--- /dev/null
+++ b/Build/source/texk/web2c/synctexdir/synctex_main.c
@@ -0,0 +1,735 @@
+/*
+Copyright (c) 2008 jerome DOT laurens AT u-bourgogne DOT fr
+
+This file is part of the SyncTeX package.
+
+License:
+--------
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE
+
+Except as contained in this notice, the name of the copyright holder
+shall not be used in advertising or otherwise to promote the sale,
+use or other dealings in this Software without prior written
+authorization from the copyright holder.
+
+Important notice:
+-----------------
+This file is named "synctex_main.c".
+This is the command line interface to the synctex_parser.c.
+*/
+
+# include "web2c/c-auto.h" /* for inline && HAVE_xxx */
+
+# include <stdlib.h>
+# include <stdio.h>
+# include <string.h>
+# include <stdarg.h>
+# include <math.h>
+# include "synctex_parser.h"
+
+/* The code below uses strlcat and strlcpy, which avoids security warnings with some compilers.
+ However, if these are not available we simply use the old, unchecked versions;
+ this is OK because all the uses in this code are working with a buffer that's been
+ allocated based on measuring the strings involved. */
+#ifndef HAVE_STRLCAT
+#define strlcat(dst, src, size) strcat((dst), (src))
+#endif
+#ifndef HAVE_STRLCPY
+#define strlcpy(dst, src, size) strcpy((dst), (src))
+#endif
+#ifndef HAVE_FMAX
+#define fmax my_fmax
+inline static double my_fmax(double x, double y) { return (x < y) ? y : x; }
+#endif
+
+#define SYNCTEX_DEBUG 0
+
+#if SYNCTEX_DEBUG
+# include "unistd.h"
+#endif
+
+int main(int argc, char *argv[]);
+
+void synctex_help(char * error,...);
+void synctex_help_view(char * error,...);
+void synctex_help_edit(char * error,...);
+
+int synctex_view(int argc, char *argv[]);
+int synctex_edit(int argc, char *argv[]);
+int synctex_update(int argc, char *argv[]);
+
+int main(int argc, char *argv[])
+{
+ int arg_index = 1;
+ printf("This is SyncTeX command line utility, version 1.0\n");
+ if(arg_index<argc) {
+ if(0==strcmp("help",argv[arg_index])) {
+ if(++arg_index<argc) {
+ if(0==strcmp("view",argv[arg_index])) {
+ synctex_help_view(NULL);
+ return 0;
+ } else if(0==strcmp("edit",argv[arg_index])) {
+ synctex_help_edit(NULL);
+ return 0;
+ }
+ }
+ synctex_help(NULL);
+ return 0;
+ } else if(0==strcmp("view",argv[arg_index])) {
+ return synctex_view(argc-arg_index-1,argv+arg_index+1);
+ } else if(0==strcmp("edit",argv[arg_index])) {
+ return synctex_edit(argc-arg_index-1,argv+arg_index+1);
+ } else if(0==strcmp("update",argv[arg_index])) {
+ return synctex_update(argc-arg_index-1,argv+arg_index+1);
+ }
+ }
+ synctex_help("Missing options");
+ return 0;
+}
+
+void synctex_usage(char * error,va_list ap) {
+ if(error) {
+ fprintf(stderr,"SyncTeX ERROR: ");
+ vfprintf(stderr,error,ap);
+ fprintf(stderr,"\n");
+ }
+ fprintf((error?stderr:stdout),
+ "usage: synctex <subcommand> [options] [args]\n"
+ "Synchronize TeXnology command-line client, version 0.1\n\n"
+ "The Synchronization TeXnology by Jérôme Laurens is a new feature of recent TeX engines.\n"
+ "It allows to synchronize between input and output, which means to\n"
+ "navigate from the source document to the typeset material and vice versa.\n\n"
+ );
+ return;
+}
+
+void synctex_help(char * error,...) {
+ va_list v;
+ va_start(v, error);
+ synctex_usage(error, v);
+ va_end(v);
+ fprintf((error?stderr:stdout),
+ "Available subcommands:\n"
+ " view to perform forwards synchronization\n"
+ " edit to perform backwards synchronization\n"
+ " update to update a synctex file after a dvi/xdv to pdf filter\n"
+ " help this help\n\n"
+ "Type 'synctex help <subcommand>' for help on a specific subcommand.\n"
+ );
+ return;
+}
+
+void synctex_help_view(char * error,...) {
+ va_list v;
+ va_start(v, error);
+ synctex_usage(error, v);
+ va_end(v);
+ fputs("synctex view: forwards or direct synchronization,\n"
+ "command sent by the editor to view the output corresponding to the position under the mouse\n"
+ "\n"
+ "usage: synctex view -i line:column:input -o output [-x viewer-command] [-h before/offset:middle/after]\n"
+ "\n"
+ "-i line:column:input\n"
+ " specify the line, column and input file.\n"
+ " The line and column are 1 based integers,\n"
+ " they allow to identify every character in a file.\n"
+ " column is the offset of a character relative to the containing line.\n"
+ " Pass 0 if this information is not relevant.\n"
+ " input is either the name of the main source file or an included document.\n"
+ " It must be the very name as understood by TeX, id est the name exactly as it appears in the log file.\n"
+ " It does not matter if the file actually exists or not, except that the command is not really useful.\n"
+ " \n"
+ "-o output\n"
+ " is the full or relative path of the output file (with any relevant path extension).\n"
+ " This file must exist.\n"
+ " \n"
+ "-x viewer-command\n"
+ " Normally the synctex tool outputs its result to the stdout.\n"
+ " It is possible to launch an external tool with the result.\n"
+ " The viewer-command is a printf like format string with following specifiers.\n"
+ " %{output} is the name specifier of the main document, without path extension.\n"
+ " %{page} is the 0 based page number specifier, %{page+1} is the 1 based page number specifier.\n"
+ " To synchronize by point, %{x} is the x coordinate specifier, %{y} is the y coordinate specifier,\n"
+ " both in dots and relative to the top left corner of the page.\n"
+ " To synchronize by box,\n"
+ " %{h} is the horizontal coordinate specifier of the origin of the enclosing box,\n"
+ " %{v} is the vertical coordinate specifier of the origin of the enclosing box,\n"
+ " both in dots and relative to the upper left corner of the page.\n"
+ " They may be different from the preceding pair of coordinates.\n"
+ " %{width} is the width specifier, %{height} is the height specifier of the enclosing box.\n"
+ " The latter dimension is naturally counted from bottom to top.\n"
+ " There is no notion of depth for such a box.\n"
+ " To synchronize by content, %{before} is the word before,\n"
+ " %{offset} is the offset specifier, %{middle} is the middle word, and %{after} is the word after.\n"
+ "\n"
+ " If no viewer command is provided, the content of the SYNCTEX_VIEWER environment variable is used instead.\n"
+ "\n"
+ "-h before/offset:middle/after\n"
+ " This hint allows a forwards synchronization by contents.\n"
+ " Instead of giving a character offset in a line, you can give full words.\n"
+ " A full word is a sequence of characters (excepting '/').\n"
+ " You will choose full words in the source document that will certainly appear unaltered in the output.\n"
+ " The \"middle\" word contains the character under the mouse at position offset.\n"
+ " \"before\" is a full word preceding middle and \"after\" is following it.\n"
+ " The before or after word can be missing, they are then considered as void strings.\n"
+ " \n",
+ (error?stderr:stdout)
+ );
+ return;
+}
+
+/* "usage: synctex view -i line:column:input -o output [-x viewer-command] [-h before/offset:middle/after]\n" */
+int synctex_view(int argc, char *argv[]) {
+ int arg_index = 0;
+ int line = -1;
+ int column = 0;
+ char * input = NULL;
+ char * viewer = NULL;
+ char * before = NULL;
+ unsigned int offset = 0;
+ char * middle = NULL;
+ char * after = NULL;
+ char * output = NULL;
+ char * start = NULL;
+ char * end = NULL;
+ synctex_scanner_t scanner = NULL;
+ size_t size = 0;
+
+ /* required */
+ if((arg_index>=argc) || strcmp("-i",argv[arg_index]) || (++arg_index>=argc)) {
+ synctex_help_view("Missing -i required argument");
+ return -1;
+ }
+ start = argv[arg_index];
+ line = strtol(start,&end,10);
+ if(end>start && strlen(end)>0 && *end==':') {
+ start = end+1;
+ column = strtol(start,&end,10);
+ if(end == start || column < 0) {
+ column = 0;
+ }
+ if(strlen(end)>1 && *end==':') {
+ input = end+1;
+ goto scan_output;
+ }
+ }
+ synctex_help_view("Bad -i argument");
+ return -1;
+scan_output:
+ if((++arg_index>=argc) || strcmp("-o",argv[arg_index]) || (++arg_index>=argc)) {
+ synctex_help_view("Missing -o required argument");
+ return -1;
+ }
+ output = argv[arg_index];
+ /* now scan the optional arguments */
+ if(++arg_index<argc) {
+ if(0 == strcmp("-x",argv[arg_index])) {
+ if(++arg_index<argc) {
+ if(strcmp("-",argv[arg_index])) {
+ /* next option does not start with '-', this is a command */
+ viewer = argv[arg_index];
+ if(++arg_index<argc) {
+ goto option_hint;
+ } else {
+ goto proceed;
+ }
+ } else {
+ /* retrieve the environment variable */
+ viewer = getenv("SYNCTEX_VIEWER");
+ goto option_hint;
+ }
+ } else {
+ viewer = getenv("SYNCTEX_VIEWER");
+ goto proceed;
+ }
+ }
+option_hint:
+ if(0 == strcmp("-h",argv[arg_index]) && ++arg_index<argc) {
+ /* modify the argument */;
+ after = strstr(argv[arg_index],"/");
+ if(NULL != after) {
+ before = argv[arg_index];
+ *after = '\0';
+ ++after;
+ offset = strtoul(after,&middle,10);
+ if(middle>after && strlen(middle)>2) {
+ after = strstr(++middle,"/");
+ if(NULL != after) {
+ *after = '\0';
+ if(offset<strlen(middle)) {
+ ++after;
+ goto proceed;
+ }
+ }
+ }
+ }
+ synctex_help_view("Bad hint");
+ return -1;
+ }
+ }
+ /* Now proceed, ignore any other argument */
+proceed:
+#if SYNCTEX_DEBUG
+ printf("line:%i\n",line);
+ printf("column:%i\n",column);
+ printf("input:%s\n",input);
+ printf("viewer:%s\n",viewer);
+ printf("before:%s\n",before);
+ printf("offset:%i\n",offset);
+ printf("middle:%s\n",middle);
+ printf("after:%s\n",after);
+ printf("output:%s\n",output);
+ printf("cwd:%s\n",getcwd(NULL,0));
+#endif
+ /* We assume that viewer is not so big: */
+# define SYNCTEX_STR_SIZE 65536
+ if(viewer && strlen(viewer)>=SYNCTEX_STR_SIZE) {
+ synctex_help_view("Viewer command is too long");
+ return -1;
+ }
+ scanner = synctex_scanner_new_with_output_file(output);
+ if(scanner && synctex_display_query(scanner,input,line,column)) {
+ synctex_node_t node = NULL;
+ if((node = synctex_next_result(scanner)) != NULL) {
+ /* filtering the command */
+ if(viewer && strlen(viewer)) {
+ char * where = NULL;
+ char * buffer = NULL;
+ char * buffer_cur = NULL;
+ int printed = 0;
+ int status = 0;
+ /* Preparing the buffer where everything will be printed */
+ size = strlen(viewer)+3*sizeof(int)+6*sizeof(float)+4*(SYNCTEX_STR_SIZE);
+ buffer = malloc(size+1);
+ if(NULL == buffer) {
+ synctex_help_view("No memory available");
+ return -1;
+ }
+ /* Properly terminate the buffer, no bad access for string related functions. */
+ buffer[size] = '\0';
+ /* Replace %{ by &{, then remove all unescaped '%'*/
+ while((where = strstr(viewer,"%{")) != NULL) {
+ *where = '&';
+ }
+ /* find all the unescaped '%', change to a safe character */
+ where = viewer;
+ while(where && (where = strstr(where,"%"))) {
+ /* Find the next occurrence of a "%",
+ * if it is not followed by another "%",
+ * replace it by a "&" */
+ if(strlen(++where)) {
+ if(*where == '%') {
+ ++where;
+ } else {
+ *(where-1)='&';
+ }
+ }
+ }
+ buffer_cur = buffer;
+ /* find the next occurrence of a format key */
+ where = viewer;
+ while(viewer && (where = strstr(viewer,"&{"))) {
+ #define TEST(KEY,FORMAT,WHAT)\
+ if(!strncmp(where,KEY,strlen(KEY))) {\
+ printed = where-viewer;\
+ if(buffer_cur != memcpy(buffer_cur,viewer,(size_t)printed)) {\
+ synctex_help_view("Memory copy problem");\
+ free(buffer);\
+ return -1;\
+ }\
+ buffer_cur += printed;size-=printed;\
+ printed = snprintf(buffer_cur,size,FORMAT,WHAT);\
+ buffer_cur += printed;size-=printed;\
+ *buffer_cur='\0';\
+ viewer = where+strlen(KEY);\
+ continue;\
+ }
+ TEST("&{output}","%s",synctex_scanner_get_output(scanner));
+ TEST("&{page}", "%i",synctex_node_page(node)-1);
+ TEST("&{page+1}","%i",synctex_node_page(node));
+ TEST("&{x}", "%f",synctex_node_visible_h(node));
+ TEST("&{y}", "%f",synctex_node_visible_v(node));
+ TEST("&{h}", "%f",synctex_node_box_visible_h(node));
+ TEST("&{v}", "%f",synctex_node_box_visible_v(node)+synctex_node_box_visible_depth(node));
+ TEST("&{width}", "%f",fabs(synctex_node_box_visible_width(node)));
+ TEST("&{height}","%f",fmax(synctex_node_box_visible_height(node)+synctex_node_box_visible_depth(node),1));
+ TEST("&{before}","%s",(before && strlen(before)<SYNCTEX_STR_SIZE?before:""));
+ TEST("&{offset}","%i",offset);
+ TEST("&{middle}","%s",(middle && strlen(middle)<SYNCTEX_STR_SIZE?middle:""));
+ TEST("&{after}", "%s",(after && strlen(after)<SYNCTEX_STR_SIZE?after:""));
+ #undef TEST
+ break;
+ }
+ /* copy the rest of viewer into the buffer */
+ if(buffer_cur != memcpy(buffer_cur,viewer,strlen(viewer))) {
+ synctex_help_view("Memory copy problem");
+ free(buffer);
+ return -1;
+ }
+ printf("SyncTeX: Executing\n%s\n",buffer);
+ status = system(buffer);
+ free(buffer);
+ buffer = NULL;
+ return status;
+ } else {
+ /* just print out the results */
+ puts("SyncTeX result begin");
+ do {
+ printf( "Output:%s\n"
+ "Page:%i\n"
+ "x:%f\n"
+ "y:%f\n"
+ "h:%f\n"
+ "v:%f\n"
+ "W:%f\n"
+ "H:%f\n"
+ "before:%s\n"
+ "offset:%i\n"
+ "middle:%s\n"
+ "after:%s\n",
+ output,
+ synctex_node_page(node),
+ synctex_node_h(node),
+ synctex_node_v(node),
+ synctex_node_box_h(node),
+ synctex_node_box_v(node)+synctex_node_box_depth(node),
+ synctex_node_box_width(node),
+ synctex_node_box_height(node)+synctex_node_box_depth(node),
+ (before?before:""),
+ offset,
+ (middle?middle:""),
+ (after?after:""));
+ } while((node = synctex_next_result(scanner)) != NULL);
+ puts("SyncTeX result end");
+ }
+ }
+ }
+ return 0;
+}
+
+void synctex_help_edit(char * error,...) {
+ va_list v;
+ va_start(v, error);
+ synctex_usage(error, v);
+ va_end(v);
+ fputs(
+ "synctex edit: backwards or reverse synchronization,\n"
+ "command sent by the viewer to edit the source corresponding to the position under the mouse\n\n"
+ "\n"
+ "usage: synctex edit -o page:x:y:file [-x editor-command] [-h offset:context]\n"
+ "\n"
+ "-o page:x:y:file\n"
+ " specify the page and coordinates of the point under the mouse.\n"
+ " page is 1 based.\n"
+ " Coordinates x and y are counted from the top left corner of the page.\n"
+ " Their unit is the big point (72 dpi).\n"
+ " \n"
+ " file is in general the path of a pdf or dvi file.\n"
+ " It can be either absolute or relative to the current directory.\n"
+ " This named file must always exist.\n"
+ " \n"
+ "-x editor-command\n"
+ " Normally the synctex tool outputs its result to the stdout.\n"
+ " It is possible to execute an external tool with the result of the query.\n"
+ " The editor-command is a printf like format string with following specifiers.\n"
+ " They will be replaced by their value before the command is executed.\n"
+ " %{output} is the full path specifier of the output document, with no extension.\n"
+ " %{input} is the name specifier of the input document.\n"
+ " %{line} is the 0 based line number specifier. %{line+1} is the 1 based line number specifier.\n"
+ " %{column} is the 0 based column number specifier or -1. %{column+1} is the 1 based column number or -1.\n"
+ " %{offset} is the 0 based offset specifier and %{context} is the context specifier of the hint.\n"
+ " \n"
+ " If no editor-command is provided, the content of the SYNCTEX_EDITOR environment variable is used instead.\n"
+ " \n"
+ "-h offset:context\n"
+ " This hint allows a backwards or reverse synchronization by contents.\n"
+ " You give a context including the character at the mouse location, and\n"
+ " the offset of this character relative to the beginning of this bunch of text.\n"
+ " \n",
+ (error?stderr:stdout)
+ );
+ return;
+}
+
+/* "usage: synctex edit -o page:x:y:output [-x editor-command] [-h offset:context]\n" */
+int synctex_edit(int argc, char *argv[]) {
+ int arg_index = 0;
+ int page = -1;
+ float x = 0;
+ float y = 0;
+ char * output = NULL;
+ char * editor = NULL;
+ int offset = 0;
+ char * context = NULL;
+ char * start = NULL;
+ char * end = NULL;
+ synctex_scanner_t scanner = NULL;
+ size_t size = 0;
+ char * where = NULL;
+ /* required */
+ if((arg_index>=argc) || strcmp("-o",argv[arg_index]) || (++arg_index>=argc)) {
+ synctex_help_view("Missing -o required argument");
+ return -1;
+ }
+ start = argv[arg_index];
+ page = strtol(start,&end,10);
+ if(end>start && strlen(end)>1 && *end==':') {
+ start = end+1;
+ x = strtod(start,&end);
+ if(end>start && strlen(end)>1 && *end==':') {
+ start = end+1;
+ y = strtod(start,&end);
+ if(end>start && strlen(end)>1 && *end==':') {
+ output = ++end;
+ goto scan_execute;
+ }
+ }
+ }
+ synctex_help_edit("Bad -o argument");
+ return -1;
+scan_execute:
+ /* now scan the optional arguments */
+ if(++arg_index<argc) {
+ if(0 == strcmp("-x",argv[arg_index])) {
+ if(++arg_index<argc) {
+ if(strcmp("-",argv[arg_index])) {
+ /* next option does not start with '-', this is a command */
+ editor = argv[arg_index];
+ if(++arg_index<argc) {
+ goto option_hint;
+ } else {
+ goto proceed;
+ }
+ } else {
+ /* retrieve the environment variable */
+ editor = getenv("SYNCTEX_EDITOR");
+ goto option_hint;
+ }
+ } else {
+ editor = getenv("SYNCTEX_EDITOR");
+ goto proceed;
+ }
+ }
+option_hint:
+ if(0 == strcmp("-h",argv[arg_index]) && ++arg_index<argc) {
+
+ start = argv[arg_index];
+ end = NULL;
+ offset = strtol(start,&end,10);
+ if(end>start && strlen(end)>1 && *end==':') {
+ context = end+1;
+ goto proceed;
+ }
+ synctex_help_edit("Bad -h argument");
+ return -1;
+ }
+ }
+proceed:
+#if SYNCTEX_DEBUG
+ printf("page:%i\n",page);
+ printf("x:%f\n",x);
+ printf("y:%f\n",y);
+ printf("almost output:%s\n",output);
+ printf("editor:%s\n",editor);
+ printf("offset:%i\n",offset);
+ printf("context:%s\n",context);
+ printf("cwd:%s\n",getcwd(NULL,0));
+#endif
+ scanner = synctex_scanner_new_with_output_file(output);
+ if(NULL == scanner) {
+ synctex_help_view("No SyncTeX available for %s",output);
+ return -1;
+ }
+ if(synctex_edit_query(scanner,page,x,y)) {
+ synctex_node_t node = NULL;
+ const char * input = NULL;
+ if(NULL != (node = synctex_next_result(scanner))
+ && NULL != (input = (char *)synctex_scanner_get_name(scanner,synctex_node_tag(node)))) {
+ /* filtering the command */
+ if(editor && strlen(editor)) {
+ char * buffer = NULL;
+ char * buffer_cur = NULL;
+ int printed;
+ int status;
+ size = strlen(editor)+3*sizeof(int)+3*SYNCTEX_STR_SIZE;
+ buffer = malloc(size+1);
+ if(NULL == buffer) {
+ printf("SyncTeX ERROR: No memory available\n");
+ return -1;
+ }
+ buffer[size]='\0';
+ /* Replace %{ by &{, then remove all unescaped '%'*/
+ while((where = strstr(editor,"%{")) != NULL) {
+ *where = '&';
+ }
+ where = editor;
+ while(where &&(where = strstr(where,"%"))) {
+ if(strlen(++where)) {
+ if(*where == '%') {
+ ++where;
+ } else {
+ *(where-1)='&';
+ }
+ }
+ }
+ buffer_cur = buffer;
+ /* find the next occurrence of a format key */
+ where = editor;
+ while(editor && (where = strstr(editor,"&{"))) {
+ #define TEST(KEY,FORMAT,WHAT)\
+ if(!strncmp(where,KEY,strlen(KEY))) {\
+ printed = where-editor;\
+ if(buffer_cur != memcpy(buffer_cur,editor,(size_t)printed)) {\
+ synctex_help_view("Memory copy problem");\
+ free(buffer);\
+ return -1;\
+ }\
+ buffer_cur += printed;size-=printed;\
+ printed = snprintf(buffer_cur,size,FORMAT,WHAT);\
+ buffer_cur += printed;size-=printed;\
+ *buffer_cur='\0';\
+ editor = where+strlen(KEY);\
+ continue;\
+ }
+ TEST("&{output}", "%s",output);
+ TEST("&{input}", "%s",input);
+ TEST("&{line}", "%i",synctex_node_line(node));
+ TEST("&{column}", "%i",-1);
+ TEST("&{offset}", "%i",offset);
+ TEST("&{context}","%s",context);
+ #undef TEST
+ break;
+ }
+ /* copy the rest of editor into the buffer */
+ if(buffer_cur != memcpy(buffer_cur,editor,strlen(editor))) {
+ fputs("! synctex_edit: Memory copy problem",stderr);
+ free(buffer);
+ return -1;
+ }\
+ printf("SyncTeX: Executing\n%s\n",buffer);
+ status = system(buffer);
+ free(buffer);
+ buffer = NULL;
+ return status;
+ } else {
+ /* just print out the results */
+ puts("SyncTeX result begin");
+ do {
+ printf( "Output:%s\n"
+ "Input:%s\n"
+ "Line:%i\n"
+ "Column:%i\n"
+ "Offset:%i\n"
+ "Context:%s\n",
+ output,
+ input,
+ synctex_node_line(node),
+ synctex_node_column(node),
+ offset,
+ (context?context:""));
+ } while((node = synctex_next_result(scanner)) != NULL);
+ puts("SyncTeX result end");
+ }
+ }
+ }
+ return 0;
+}
+
+void synctex_help_update(char * error,...) {
+ va_list v;
+ va_start(v, error);
+ synctex_usage(error, v);
+ va_end(v);
+ fputs(
+ "synctex update: up to date synctex file,\n"
+ "Use this command to update the synctex file once a dvi/xdv to pdf filter is applied.\n\n"
+ "\n"
+ "usage: synctex update -o output [-m number] [-x dimension] [-y dimension]\n"
+ "\n"
+ "-o output is the full or relative path of an existing file,.\n"
+ " either the real synctex file you wish to update\n"
+ " or a related file: foo.tex, foo.pdf, foo.dvi...\n"
+ "-m number Set additional magnification\n"
+ "-x dimension Set horizontal offset\n"
+ "-y dimension Set vertical offset\n"
+ "In general, these are exactly the options provided to the dvi/xdv to pdf filter.\n",
+ (error?stderr:stdout)
+ );
+ return;
+}
+
+/* "usage: synctex update -o output [-m number] [-x dimension] [-y dimension]\n" */
+int synctex_update(int argc, char *argv[]) {
+ int arg_index = 0;
+ synctex_updater_t updater = NULL;
+ char * magnification = NULL;
+ char * x = NULL;
+ char * y = NULL;
+ char * output = NULL;
+ #define SYNCTEX_fprintf (*synctex_fprintf)
+ if(arg_index>=argc) {
+ synctex_help_update("Bad update command");
+ return -1;
+ }
+ /* required */
+ if((arg_index>=argc) || strcmp("-o",argv[arg_index]) || (++arg_index>=argc)) {
+ synctex_help_update("Missing -o required argument");
+ return -1;
+ }
+ output = argv[arg_index];
+ if(++arg_index>=argc) {
+ return 0;
+ }
+next_argument:
+ if(0 == strcmp("-m",argv[arg_index])) {
+ if(++arg_index>=argc) {
+ synctex_help_update("Missing magnification");
+ return -1;
+ }
+ magnification = argv[arg_index];
+prepare_next_argument:
+ if(++arg_index<argc) {
+ goto next_argument;
+ }
+ } else if(0 == strcmp("-x",argv[arg_index])) {
+ if(++arg_index>=argc) {
+ synctex_help_update("Missing x offset");
+ return -1;
+ }
+ x = argv[arg_index];
+ goto prepare_next_argument;
+ } else if(0 == strcmp("-y",argv[arg_index])) {
+ if(++arg_index>=argc) {
+ synctex_help_update("Missing y offset");
+ return -1;
+ }
+ y = argv[arg_index];
+ goto prepare_next_argument;
+ }
+ /* Arguments parsed */
+ updater = synctex_updater_new_with_output_file(output);
+ synctex_updater_append_magnification(updater,magnification);
+ synctex_updater_append_x_offset(updater,x);
+ synctex_updater_append_y_offset(updater,y);
+ synctex_updater_free(updater);
+ return 0;
+}