当前位置: 首页 > article >正文

一个阅读英文文档的记录与思考:

背景:我在阅读文档的时候总会有一些疑惑,

关于这些是什么,这他妈怎么用800个生词解释一个生词,这都是什么狗屁东西等等

这个变量为什么没提到过,又尼玛有个新造的词组什么意思阿  等等

关于这些问题,他们直接或间接地导致我超级不愿意阅读英文文档,每次出现问题都习惯性地找谷歌,或者直接摆烂。不时说直接谷歌不好,而是对于一些需要经常用的东西,需要系统学一下,要自己有概念有框架的东西,直接谷歌效率极其低下而且可能获得的指导很片面(甚至直接就是错的),这是在埋地雷,对我自己来说是一种很不负责任的行为

同时本文也涉及到一些基本的符号表达,含义表述,一些单词我的理解,以及**如何理解一些文档中新出现的单词的策略**

==》我试图记录一下子阅读文档面临的问题,和我目前尝试解决的方法,方便自己查阅反思,如果也能帮到你,这也很让我开心啦hh

1. 一些文档中介绍参数的符号:

命令 <必选参数1|必选参数2> [-option {必选参数1|必选参数2|必选参数3}] [可选参数...] {(默认参数)|参数|参数}

(一)基本符号:

- 尖括号< >:必选参数,实际使用时应将其替换为所需要的参数

- 大括号{ }:必选参数,内部使用,包含此处允许使用的参数

- 方括号[ ]:可选参数,在命令中根据需要加以取舍

- 小括号( ):指明参数的默认值,只用于{ }中

- 竖线|:用于分隔多个互斥参数,含义为“或”,使用时只能选择一个。

- 省略号...:任意多个参数

 (二)多个可选参数:

`[, a, b, c]` 含义是: a,b,c 三者是看作一组的可选参数,即,要么一起出现,要么一起省略

`[, a [, b] [, c] ]` 含义是: b,c 是平行于a的可选参数,即,可以 只传入 a, 可以只传入 b,可以只传入 c ,也可以 a,b ; a,c ; b,c ; a,b,c ;

(三)函数中的关键字:

例如:

cmake_minimum_required(VERSION <min>[...<policy_max>] [FATAL_ERROR]) 

cmake_minimum_required() 是函数名字,

而其中的参数:`VERSION` 是一个需要写到参数中的内容

`<min>` 则是一个必选项,这个必选项中填入的值用一个变量指代,这个变量是min  -- 一般在后续的文档中会对这个 `min` 变量的含义进行阐述

因此,我们可以总结一下:对于只是作为变量名,在使用时会被具体内容所替换掉的变量,会写在 <> 或者 [ ] 符号中;反之,作为使用中充当字符串存在在函数参数中的内容,则不会被  <> 或者 [ ] 符号所包含,

所以,一个普通的写法例子是:`make_minimum_required(VERSION 3.10)`

2. settable variable 用法:有些变量是由CMAKE直接定义好了,用来显示一些含义

我之前会把他理解为关键字,但是还不太准确,这是一类定义好含义的,在CMAKE 执行阶段会被赋初值(如果我们在CMakeLinks.txt文件中有指定,那么,按我们的set()来,没有指定就有一个默认的初始值),因此,被称作是 settable variable

这就体现了读文档的好处:在第一次见到这种语法时(可能其他的脚本语言(我猜测大概率也会有这种语法结构),但对于第一次遇到这种语言结构的人来说:在第一次出现这种语法结构时,它会给你来一段定义,如下图蓝色部分)

实话说,我第一次读到这的时候对于这段定义的理解也不咋深入,什么狗皮东西没见过。后来这种settable variable 来指定或显示具体涵义的用法越来越多的时候,在重新回头找定义就读懂了

==》因此,我目前的策略是,遇到这种没见过的用法,在第一次出现的时候,一般tutorial 中都会给出解释,标亮或者记录一下,方便以后回头来进一步理解(因为妄图一次就理解清楚基本是不可能的,暂时先别想了)

这引申出另一个问题,我后续在不断的做tutorial时候会发现这些变量用的频率很高,但是“我不知道有哪些 settable variable”可用,我应该去哪里查找呢?

一般来说,这种词不会太多,然后一般文档也会有个总结

对于CMAKE ,我找到关于这些 settable variable 的总结 的查找方法是:

发现文档中 “CMAKE_CXX_STANDARD” 可以点击跳转,于是点击进入该变量的介绍文档,然后一版文档会显示 该变量的介绍文档的路径,如下图所示,然后我们点进去就好啦:

 详细列出了很多变量,最上面还有这些settable variable 的分类,很贴心,而且一般文档都是很贴心的!

当我看不懂一个东西的时候,我应该继续,还是应该速速看别人的博客来回理解呢?

我打算采取的策略是,看别人的博客吧

还有一个疑问是:一些关键字的含义都他妈的是看明白的阿,以及,别说是看明白了,我他嘛有时候都不知道这些关键字的存在,不是我靠,这些关键字都从哪里列出来的阿????


http://www.kler.cn/news/108729.html

相关文章:

  • 【3D 图像分割】基于 Pytorch 的 VNet 3D 图像分割6(数据预处理)
  • 智能水厂运行与调控3D模拟仿真在线展示提高整个系统的协同效应
  • Unity Spine 指定导入新Spine动画的默认材质
  • 飞鼠异地组网工具基本使用教程
  • 第五章 I/O管理 二、I/O控制器
  • 大数据-Storm流式框架(八)---Storm案例
  • Docker 批量导入镜像
  • VTK OrientationMarker 方向 三维坐标系 相机坐标轴 自定义坐标轴
  • Monocular arbitrary moving object discovery and segmentation 论文阅读
  • IconWorkshop 6软件官方下载:制作ICO/ICON图标、编辑、转换图标
  • Web攻防06_sqlmap的使用
  • Java面试基础篇
  • 《C和指针》(6)指针
  • JAVA面试题简单整理
  • php使用lunar实现农历、阳历、节日等功能
  • SpringBoot小项目——简单的小区物业后台管理系统 认证鉴权 用户-角色模型 AOP切面日志 全局异常【源码】
  • 云原生微服务治理 第四章 Spring Cloud Netflix 服务注册/发现组件Eureka
  • 【C++项目】高并发内存池第五讲内存回收释放过程介绍
  • 如何利用 ChatGPT 提升编程技能
  • RabbitMQ生产者的可靠性
  • 洛谷 B2029 大象喝水 C++代码
  • pandas笔记
  • spring-aop-execution表达式
  • vue3.0运行npm run dev 报错Cannot find module node:url
  • 文心一言 VS 讯飞星火 VS chatgpt (123)-- 算法导论10.4 4题
  • Java SE 学习笔记(十七)—— 单元测试、反射
  • POJ 1201 Intervals 线段树
  • 微信小程序之投票管理
  • Leetcode—274.H指数【中等】
  • Java 四种引用类型