Author: Alexander Malkov Date: 2022-08-19T09:54:29Z New Revision: cd86a03246a2df350c2f694457f1ce946cf65663
URL: https://github.com/llvm/llvm-project/commit/cd86a03246a2df350c2f694457f1ce946cf65663 DIFF: https://github.com/llvm/llvm-project/commit/cd86a03246a2df350c2f694457f1ce946cf65663.diff LOG: [clang,flang] Add help text for -fsyntax-only Fix for the problem with displaying options `-fsyntax-only` in clang and flang-new in help Fix https://github.com/llvm/llvm-project/issues/57033 Before: ``` $ clang -help | grep syntax -objcmt-migrate-property-dot-syntax Enable migration of setter/getter messages to property-dot syntax ``` After: ``` $ clang -help | grep syntax -fsyntax-only Run the preprocessor, parser and semantic analysis stages -objcmt-migrate-property-dot-syntax Enable migration of setter/getter messages to property-dot syntax ``` Reviewed By: vzakhari, awarzynski, MaskRay, alexiprof Differential Revision: https://reviews.llvm.org/D131808 Added: Modified: clang/docs/ClangCommandLineReference.rst clang/docs/CommandGuide/clang.rst clang/docs/UsersManual.rst clang/include/clang/Driver/Options.td flang/test/Driver/driver-help-hidden.f90 flang/test/Driver/driver-help.f90 Removed: ################################################################################ diff --git a/clang/docs/ClangCommandLineReference.rst b/clang/docs/ClangCommandLineReference.rst index 265a6d7beb6e9..7f9ef3783f9da 100644 --- a/clang/docs/ClangCommandLineReference.rst +++ b/clang/docs/ClangCommandLineReference.rst @@ -831,6 +831,8 @@ Only run the driver. .. option:: -fsyntax-only +Run the preprocessor, parser and semantic analysis stages + .. option:: -module-file-info Provide information about a particular module file diff --git a/clang/docs/CommandGuide/clang.rst b/clang/docs/CommandGuide/clang.rst index af2b0df98d3dc..5e344ec702777 100644 --- a/clang/docs/CommandGuide/clang.rst +++ b/clang/docs/CommandGuide/clang.rst @@ -75,7 +75,7 @@ Stage Selection Options .. option:: -fsyntax-only - Run the preprocessor, parser and type checking stages. + Run the preprocessor, parser and semantic analysis stages. .. option:: -S diff --git a/clang/docs/UsersManual.rst b/clang/docs/UsersManual.rst index f9ccca65f3889..78ccf4572ffc8 100644 --- a/clang/docs/UsersManual.rst +++ b/clang/docs/UsersManual.rst @@ -3999,7 +3999,7 @@ Execute ``clang-cl /?`` to see a list of supported options: /Zl Don't mention any default libraries in the object file /Zp Set the default maximum struct packing alignment to 1 /Zp<value> Specify the default maximum struct packing alignment - /Zs Syntax-check only + /Zs Run the preprocessor, parser and semantic analysis stages OPTIONS: -### Print (but do not run) the commands to run for this compilation @@ -4130,6 +4130,7 @@ Execute ``clang-cl /?`` to see a list of supported options: behavior. See user manual for available checks -fsplit-lto-unit Enables splitting of the LTO unit. -fstandalone-debug Emit full debug info for all types used by the program + -fsyntax-only Run the preprocessor, parser and semantic analysis stages -fwhole-program-vtables Enables whole-program vtable optimization. Requires -flto -gcodeview-ghash Emit type record hashes in a .debug$H section -gcodeview Generate CodeView debug information diff --git a/clang/include/clang/Driver/Options.td b/clang/include/clang/Driver/Options.td index a5dfeec4fd463..c8178c13e82e9 100644 --- a/clang/include/clang/Driver/Options.td +++ b/clang/include/clang/Driver/Options.td @@ -2800,7 +2800,8 @@ def fstrict_overflow : Flag<["-"], "fstrict-overflow">, Group<f_Group>; def fdriver_only : Flag<["-"], "fdriver-only">, Flags<[NoXarchOption, CoreOption]>, Group<Action_Group>, HelpText<"Only run the driver.">; def fsyntax_only : Flag<["-"], "fsyntax-only">, - Flags<[NoXarchOption,CoreOption,CC1Option,FC1Option]>, Group<Action_Group>; + Flags<[NoXarchOption,CoreOption,CC1Option,FC1Option,FlangOption]>, Group<Action_Group>, + HelpText<"Run the preprocessor, parser and semantic analysis stages">; def ftabstop_EQ : Joined<["-"], "ftabstop=">, Group<f_Group>; def ftemplate_depth_EQ : Joined<["-"], "ftemplate-depth=">, Group<f_Group>; def ftemplate_depth_ : Joined<["-"], "ftemplate-depth-">, Group<f_Group>; @@ -6618,7 +6619,7 @@ def _SLASH_Zp : CLJoined<"Zp">, def _SLASH_Zp_flag : CLFlag<"Zp">, HelpText<"Set default maximum struct packing alignment to 1">, Alias<fpack_struct_EQ>, AliasArgs<["1"]>; -def _SLASH_Zs : CLFlag<"Zs">, HelpText<"Syntax-check only">, +def _SLASH_Zs : CLFlag<"Zs">, HelpText<"Run the preprocessor, parser and semantic analysis stages">, Alias<fsyntax_only>; def _SLASH_openmp_ : CLFlag<"openmp-">, HelpText<"Disable OpenMP support">, Alias<fno_openmp>; diff --git a/flang/test/Driver/driver-help-hidden.f90 b/flang/test/Driver/driver-help-hidden.f90 index 929b64e5455f0..8261620a2259e 100644 --- a/flang/test/Driver/driver-help-hidden.f90 +++ b/flang/test/Driver/driver-help-hidden.f90 @@ -44,6 +44,7 @@ ! CHECK-NEXT: -fno-integrated-as Disable the integrated assembler ! CHECK-NEXT: -fopenacc Enable OpenACC ! CHECK-NEXT: -fopenmp Parse OpenMP pragmas and generate parallel code. +! CHECK-NEXT: -fsyntax-only Run the preprocessor, parser and semantic analysis stages ! CHECK-NEXT: -fxor-operator Enable .XOR. as a synonym of .NEQV. ! CHECK-NEXT: -help Display available options ! CHECK-NEXT: -I <dir> Add directory to the end of the list of include search paths diff --git a/flang/test/Driver/driver-help.f90 b/flang/test/Driver/driver-help.f90 index fd388ca9959bb..3df94d25cea2c 100644 --- a/flang/test/Driver/driver-help.f90 +++ b/flang/test/Driver/driver-help.f90 @@ -42,6 +42,7 @@ ! HELP-NEXT: -fno-integrated-as Disable the integrated assembler ! HELP-NEXT: -fopenacc Enable OpenACC ! HELP-NEXT: -fopenmp Parse OpenMP pragmas and generate parallel code. +! HELP-NEXT: -fsyntax-only Run the preprocessor, parser and semantic analysis stages ! HELP-NEXT: -fxor-operator Enable .XOR. as a synonym of .NEQV. ! HELP-NEXT: -help Display available options ! HELP-NEXT: -I <dir> Add directory to the end of the list of include search paths @@ -119,6 +120,7 @@ ! HELP-FC1-NEXT: -fno-reformat Dump the cooked character stream in -E mode ! HELP-FC1-NEXT: -fopenacc Enable OpenACC ! HELP-FC1-NEXT: -fopenmp Parse OpenMP pragmas and generate parallel code. +! HELP-FC1-NEXT: -fsyntax-only Run the preprocessor, parser and semantic analysis stages ! HELP-FC1-NEXT: -fxor-operator Enable .XOR. as a synonym of .NEQV. ! HELP-FC1-NEXT: -help Display available options ! HELP-FC1-NEXT: -init-only Only execute frontend initialization _______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
